@lark-apaas/coding-steering 0.1.18-dev.4e64c13 → 0.1.18-dev.5c16901

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

@@ -0,0 +1,60 @@
+#!/usr/bin/env python3
+"""Regression test for the generated consumer-facing color contract."""
+import os
+import tempfile
+import unittest
+
+from draft import emit_body
+
+
+class ColorContractTest(unittest.TestCase):
+    def test_body_allows_supporting_colors_without_a_second_accent_system(self):
+        data = {
+            'canvas': {'px': [1920, 1080]},
+            'counts': {'slides': 1},
+            'form_hint': {'form': 3},
+        }
+        tokens = [
+            ('primary', {'hex': '#123456'}),
+            ('surface', {'hex': '#FFFFFF'}),
+        ]
+        fonts = [
+            {
+                'names': ['Example Sans'],
+                'stack': ['Example Sans', 'Noto Sans SC'],
+            },
+        ]
+        roles = {'body': {'sz_px': 36}}
+        archetypes = [
+            {
+                'name': 'content',
+                'slots': [],
+            },
+        ]
+
+        with tempfile.TemporaryDirectory() as output_dir:
+            emit_body(
+                data,
+                tokens,
+                fonts,
+                roles,
+                [],
+                archetypes,
+                [],
+                {},
+                output_dir,
+            )
+            with open(os.path.join(output_dir, 'body.md'), encoding='utf-8') as stream:
+                body = stream.read()
+
+        self.assertIn('允许新增中性色、低彩度辅助色或局部语义色', body)
+        self.assertRegex(body, r'正负.*风险.*警告.*状态.*图表序列')
+        self.assertIn('必要时可以使用 Colors 之外的颜色', body)
+        self.assertIn('不能形成与模板主色竞争的第二强调色', body)
+        self.assertIn('色相、明度和饱和度关系', body)
+        self.assertIn('高饱和、高对比、大面积或跨页重复', body)
+        self.assertIn('标题、关键数字、图表主序列、卡片底色或渐变', body)
+
+
+if __name__ == '__main__':
+    unittest.main()

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

@@ -0,0 +1,62 @@
+#!/usr/bin/env python3
+"""Regression tests for consumer rules emitted into design.md."""
+import os
+import tempfile
+import unittest
+
+from draft import emit_body
+
+
+class DesignConsumerContractTest(unittest.TestCase):
+    def test_generated_design_owns_template_consumption_rules(self):
+        data = {
+            'canvas': {'px': [1920, 1080]},
+            'counts': {'slides': 1},
+            'form_hint': {'form': 3},
+        }
+        tokens = [('primary', {'hex': '#123456'})]
+        fonts = [
+            {
+                'names': ['Example Sans'],
+                'stack': ['Example Sans', 'Noto Sans SC'],
+            },
+        ]
+        roles = {'body': {'sz_px': 36}}
+        assets = [
+            {
+                'id': 'bg-content',
+                'kind': 'background',
+                'role': 'content',
+            },
+        ]
+        archetypes = [{'name': 'content', 'slots': []}]
+
+        with tempfile.TemporaryDirectory() as output_dir:
+            emit_body(
+                data,
+                tokens,
+                fonts,
+                roles,
+                assets,
+                archetypes,
+                [],
+                {},
+                output_dir,
+            )
+            with open(os.path.join(output_dir, 'body.md'), encoding='utf-8') as stream:
+                body = stream.read()
+
+        self.assertIn('是全局 token', body)
+        self.assertIn('局部 slot / decor 的 `css` 优先', body)
+        self.assertIn('字体使用 Typography 的完整栈与降级', body)
+        self.assertIn('将包内 `assets/` 复制到项目内相对目录', body)
+        self.assertIn('本机绝对路径', body)
+        self.assertIn('背景、资产和本段规则均来自本风格包', body)
+        self.assertIn('页面无资源加载失败、内容溢出或画幅裁切', body)
+        self.assertIn('沿用该页型已有的标题层级与局部 `css`', body)
+        self.assertIn('背景中已经可见的固定标题不再创建文本', body)
+        self.assertIn('没有 `subtitle` 槽就不新增副标题', body)
+
+
+if __name__ == '__main__':
+    unittest.main()

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

@@ -0,0 +1,378 @@
+#!/usr/bin/env python3
+"""Regression tests for model-selected flow layouts and grouped card columns."""
+import os
+import sys
+import tempfile
+import unittest
+
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+
+from draft import draft_flow, draft_layouts, emit_layouts
+from check_v2 import Pack, rule_v2_14, rule_v2_16
+from package import Fail, build_layouts_md, split_top_blocks
+
+
+def text_slot(role, box, text):
+    return {
+        'role': role,
+        'type': 'title' if role == 'title' else 'body',
+        'box': box,
+        'sz': 36,
+        'txt': text,
+        'css': 'font-size: 36px',
+    }
+
+
+class FlowLayoutContractTest(unittest.TestCase):
+    def test_sample_page_keeps_every_text_slot_for_card_grouping(self):
+        slide_part = 'ppt/slides/slide2.xml'
+        layout_part = 'ppt/slideLayouts/slideLayout2.xml'
+        shapes = []
+        for index in range(8):
+            shapes.append({
+                'part': slide_part,
+                'layer': 'slide',
+                'id': str(index + 1),
+                'kind': 'sp',
+                'name': 'Text',
+                'ph': None,
+                'box': {'x': 100 + (index % 3) * 560, 'y': 100 + index * 80,
+                        'w': 480, 'h': 60},
+                'text': {
+                    'bodyPr': {},
+                    'lstStyle': {'lvl1pPr': {'sz_px': 32}},
+                    'paragraphs': [{'runs': [{'text': 'Text %d' % index}]}],
+                },
+            })
+        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:
+                import json
+                json.dump({'shapes': shapes}, stream)
+            archetypes, _, _ = draft_layouts(data, output_dir)
+
+        self.assertEqual(len(archetypes[0]['slots']), 8)
+
+    def test_layout_mode_selects_flow_without_leaking_draft_control(self):
+        draft = """names:
+  layout-1: 内容页
+roles:
+  layout-1: content
+layout_modes:
+  layout-1: flow
+layouts:
+  layout-1:
+    flow:
+      top: 100
+      margin: [80, 80]
+      gap: 40
+      regions:
+        - kind: stack
+          gap: 20
+          items:
+            - {role: title, type: title}
+            - {role: body, type: body}
+    slots:
+      - {role: title, box: [80, 100, 1760, 80], type: title}
+      - {role: body, box: [80, 220, 1760, 400], type: body}
+    confidence: high
+"""
+
+        layouts_md = build_layouts_md(split_top_blocks(draft), (1920, 1080))
+
+        self.assertIn('    flow:', layouts_md)
+        self.assertNotIn('    slots:', layouts_md)
+        self.assertNotIn('layout_modes:', layouts_md)
+
+        slots_md = build_layouts_md(
+            split_top_blocks(draft.replace('layout-1: flow', 'layout-1: slots')),
+            (1920, 1080),
+        )
+
+        self.assertIn('    slots:', slots_md)
+        self.assertNotIn('    flow:', slots_md)
+        self.assertNotIn('layout_modes:', slots_md)
+
+    def test_layout_mode_is_required_when_both_forms_exist(self):
+        draft = """names:
+  layout-1: 内容页
+roles:
+  layout-1: content
+layouts:
+  layout-1:
+    flow:
+      top: 100
+      margin: [80, 80]
+      gap: 40
+      regions:
+        - kind: stack
+          items:
+            - {role: title, type: title}
+            - {role: body, type: body}
+    slots:
+      - {role: title, box: [80, 100, 1760, 80], type: title}
+      - {role: body, box: [80, 220, 1760, 400], type: body}
+    confidence: high
+"""
+
+        with self.assertRaisesRegex(Fail, 'layout-1 缺 layout_modes 判断'):
+            build_layouts_md(split_top_blocks(draft), (1920, 1080))
+
+    def test_layout_mode_rejects_unknown_value(self):
+        draft = """names:
+  layout-1: 内容页
+roles:
+  layout-1: content
+layout_modes:
+  layout-1: auto
+layouts:
+  layout-1:
+    flow:
+      top: 100
+      margin: [80, 80]
+      gap: 40
+      regions:
+        - kind: stack
+          items:
+            - {role: title, type: title}
+            - {role: body, type: body}
+    slots:
+      - {role: title, box: [80, 100, 1760, 80], type: title}
+      - {role: body, box: [80, 220, 1760, 400], type: body}
+    confidence: high
+"""
+
+        with self.assertRaisesRegex(Fail, "layout-1 的 layout_modes 判断是 'auto'"):
+            build_layouts_md(split_top_blocks(draft), (1920, 1080))
+
+    def test_model_identified_footer_moves_to_positioned_free_region(self):
+        draft = """names:
+  layout-1: 内容页
+roles:
+  layout-1: content
+text_roles:
+  layout-1-text-1: title
+  layout-1-text-2: body
+  layout-1-text-3: footer
+layout_modes:
+  layout-1: flow
+layouts:
+  layout-1:
+    flow:
+      top: 100
+      margin: [80, 80]
+      gap: 40
+      regions:
+        - kind: stack
+          gap: 20
+          items:
+            # text-role: layout-1-text-1
+            - {role: body, type: body}
+            # text-role: layout-1-text-2
+            - {role: body, type: body}
+            # text-role: layout-1-text-3
+            - {role: body, type: body}
+    slots:
+      # text-role: layout-1-text-1
+      - {role: body, box: [80, 100, 1760, 80], type: body}
+      # text-role: layout-1-text-2
+      - {role: body, box: [80, 220, 1760, 400], type: body}
+      # text-role: layout-1-text-3
+      - {role: body, box: [80, 1000, 1760, 40], type: body}
+    confidence: high
+"""
+
+        layouts_md = build_layouts_md(split_top_blocks(draft), (1920, 1080))
+
+        self.assertIn('        - kind: free', layouts_md)
+        self.assertIn(
+            '- {role: footer, box: [80, 1000, 1760, 40], type: footer}',
+            layouts_md,
+        )
+        stack = layouts_md.split('        - kind: stack', 1)[1].split(
+            '        - kind: free', 1,
+        )[0]
+        self.assertNotIn('role: footer', stack)
+
+    def test_multicolumn_cards_emit_one_level_groups(self):
+        archetype = {
+            'name': 'layout-1',
+            'zh': '三列问题页',
+            'role': 'content',
+            'bg': None,
+            'slots': [
+                text_slot('title', [120, 80, 1680, 80], '三大关键问题'),
+                text_slot('summary', [120, 200, 1680, 80], '本季度核心问题摘要'),
+                text_slot('card-title', [150, 360, 480, 60], '毛利承压'),
+                text_slot('body', [150, 440, 480, 180], '毛利率低于目标'),
+                text_slot('card-title', [720, 360, 480, 60], '收入延期'),
+                text_slot('body', [720, 440, 480, 180], '重点项目验收延后'),
+                text_slot('card-title', [1290, 360, 480, 60], '续约下滑'),
+                text_slot('body', [1290, 440, 480, 180], '中小客户流失增加'),
+            ],
+            'decor': [
+                {
+                    'box': [120, 330, 540, 420],
+                    'geom': 'rect',
+                    'css': 'background: #FFFFFF; border: 1px solid #DDE7F2',
+                },
+                {
+                    'box': [690, 330, 540, 420],
+                    'geom': 'rect',
+                    'css': 'background: #FFFFFF; border: 1px solid #DDE7F2',
+                },
+                {
+                    'box': [1260, 330, 540, 420],
+                    'geom': 'rect',
+                    'css': 'background: #FFFFFF; border: 1px solid #DDE7F2',
+                },
+                {
+                    'box': [115, 660, 550, 95],
+                    'geom': 'rect',
+                    'css': 'background: #0A84FF',
+                },
+                {
+                    'box': [685, 660, 550, 95],
+                    'geom': 'rect',
+                    'css': 'background: #0A84FF',
+                },
+                {
+                    'box': [1255, 660, 550, 95],
+                    'geom': 'rect',
+                    'css': 'background: #0A84FF',
+                },
+            ],
+            'pages': [2],
+            'rep': 2,
+            'pic_n': 0,
+            'confidence': 'medium',
+        }
+        archetype['flow'] = draft_flow(archetype, {}, (1920, 1080))
+
+        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()
+
+        self.assertIn('layout_modes:', layouts_yaml)
+        self.assertIn('  layout-1: TODO布局模式', layouts_yaml)
+        self.assertIn('        - kind: grid\n          cols: 3', layouts_yaml)
+        self.assertEqual(layouts_yaml.count('            - role: group'), 3)
+        self.assertEqual(layouts_yaml.count('              items:'), 3)
+        self.assertEqual(layouts_yaml.count('role: container'), 3)
+
+        decided = layouts_yaml.replace('TODO布局模式', 'flow')
+        layouts_md = build_layouts_md(split_top_blocks(decided), (1920, 1080))
+
+        self.assertNotIn('layout_modes:', layouts_md)
+        self.assertNotIn('    slots:', layouts_md)
+        self.assertIn('    flow:', layouts_md)
+        self.assertEqual(layouts_md.count('            - role: group'), 3)
+        self.assertEqual(layouts_md.count('              items:'), 3)
+
+        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')
+            with open(os.path.join(pack_dir, 'layouts.md'), 'w', encoding='utf-8') as stream:
+                stream.write(layouts_md)
+            pack = Pack(pack_dir)
+
+        self.assertEqual(rule_v2_14(pack).level, 'PASS')
+        self.assertEqual(rule_v2_16(pack).level, 'PASS')
+
+    def test_title_and_single_card_row_gap_form_two_flow_regions(self):
+        archetype = {
+            'name': 'layout-1',
+            'zh': '标题加三列卡片',
+            'role': 'content',
+            'bg': None,
+            'slots': [
+                text_slot('title', [228, 73, 1465, 68], '核心能力'),
+            ],
+            'decor': [],
+            'pages': [2],
+            'rep': 2,
+            'pic_n': 0,
+            'confidence': 'high',
+        }
+        for left in (70, 671, 1270):
+            archetype['decor'].append({
+                'box': [left, 212, 580, 660],
+                'geom': 'rect',
+                'css': 'background: rgba(255,255,255,0.7)',
+            })
+            for top in (270, 374, 498, 621, 797):
+                archetype['slots'].append(
+                    text_slot('body', [left + 80, top, 405, 41], '卡片内容'),
+                )
+
+        flow = draft_flow(archetype, {}, (1920, 1080))
+
+        self.assertIsNotNone(flow)
+        self.assertEqual([region['kind'] for region in flow['regions']], ['stack', 'grid'])
+        self.assertEqual(flow['regions'][1]['cols'], 3)
+        self.assertEqual(
+            [item['role'] for item in flow['regions'][1]['items']],
+            ['group', 'group', 'group'],
+        )
+
+    def test_fixed_template_anchors_stay_in_a_positioned_free_region(self):
+        archetype = {
+            'name': 'layout-1',
+            'zh': '内容页',
+            'role': 'content',
+            'bg': None,
+            'slots': [
+                text_slot('title', [120, 100, 1680, 80], '标题'),
+                text_slot('body', [120, 260, 1680, 280], '正文'),
+                {
+                    'role': 'logo',
+                    'type': 'pic',
+                    'box': [1740, 40, 100, 60],
+                    'sz': 0,
+                    'txt': '',
+                    'asset': 'logo-primary',
+                },
+                {
+                    'role': 'slide-number',
+                    'type': 'slide-number',
+                    'box': [1780, 1000, 60, 40],
+                    'sz': 24,
+                    'txt': '2',
+                    'css': 'font-size: 24px',
+                },
+            ],
+            'decor': [],
+            'pages': [2],
+            'rep': 2,
+            'pic_n': 1,
+            'confidence': 'medium',
+        }
+        archetype['flow'] = draft_flow(archetype, {}, (1920, 1080))
+
+        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()
+
+        self.assertIn('        - kind: free', layouts_yaml)
+        self.assertIn(
+            '- {role: logo, type: pic, box: [1740, 40, 100, 60], asset: logo-primary}',
+            layouts_yaml,
+        )
+        self.assertIn(
+            '- {role: slide-number, type: slide-number, box: [1780, 1000, 60, 40]',
+            layouts_yaml,
+        )
+
+
+if __name__ == '__main__':
+    unittest.main()

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

@@ -0,0 +1,98 @@
+#!/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])
+
+
+if __name__ == '__main__':
+    unittest.main()