@litfamily/litcodex 1.0.15 → 1.0.16

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (120) hide show
  1. package/README-Ko-KR.md +10 -10
  2. package/README.md +10 -10
  3. package/dist/install/generated-skill-payload-hashes.d.ts +101 -40
  4. package/dist/install/generated-skill-payload-hashes.js +101 -40
  5. package/marketplace/plugins/litcodex/.codex-plugin/plugin.json +1 -1
  6. package/marketplace/plugins/litcodex/components/auto-update/package.json +1 -1
  7. package/marketplace/plugins/litcodex/components/comment-checker/package.json +1 -1
  8. package/marketplace/plugins/litcodex/components/git-bash/package.json +1 -1
  9. package/marketplace/plugins/litcodex/components/lit-loop/package.json +1 -1
  10. package/marketplace/plugins/litcodex/components/lsp/package.json +1 -1
  11. package/marketplace/plugins/litcodex/components/rules/package.json +1 -1
  12. package/marketplace/plugins/litcodex/components/start-work-continuation/package.json +1 -1
  13. package/marketplace/plugins/litcodex/components/telemetry/package.json +1 -1
  14. package/marketplace/plugins/litcodex/components/wikify-knowledge/package.json +1 -1
  15. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/THIRD-PARTY-NOTICE.txt +0 -2
  16. package/marketplace/plugins/litcodex/skills/lit-docx/SKILL.md +16 -12
  17. package/marketplace/plugins/litcodex/skills/lit-docx/references/components.md +113 -0
  18. package/marketplace/plugins/litcodex/skills/lit-docx/references/direction-step.md +164 -0
  19. package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/01-report-ko.md +95 -0
  20. package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/02-brief-ko.md +45 -0
  21. package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/03-manual-ko.md +105 -0
  22. package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/04-proposal-ko.md +97 -0
  23. package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/05-memo-en.md +34 -0
  24. package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/06-journal-en.md +89 -0
  25. package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/07-report-en.md +101 -0
  26. package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/08-proposal-en.md +94 -0
  27. package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/09-memo-ko.md +34 -0
  28. package/marketplace/plugins/litcodex/skills/lit-docx/references/page-composition.md +141 -0
  29. package/marketplace/plugins/litcodex/skills/lit-docx/references/tonalities/brief.md +70 -0
  30. package/marketplace/plugins/litcodex/skills/lit-docx/references/tonalities/journal.md +73 -0
  31. package/marketplace/plugins/litcodex/skills/lit-docx/references/tonalities/manual.md +70 -0
  32. package/marketplace/plugins/litcodex/skills/lit-docx/references/tonalities/memo.md +75 -0
  33. package/marketplace/plugins/litcodex/skills/lit-docx/references/tonalities/proposal.md +71 -0
  34. package/marketplace/plugins/litcodex/skills/lit-docx/references/tonalities/report.md +83 -0
  35. package/marketplace/plugins/litcodex/skills/lit-docx/scripts/convert_md_to_docx.py +401 -58
  36. package/marketplace/plugins/litcodex/skills/lit-docx/scripts/docx_craft.py +124 -1
  37. package/marketplace/plugins/litcodex/skills/lit-docx/scripts/docx_design.py +2446 -0
  38. package/marketplace/plugins/litcodex/skills/lit-docx/scripts/docx_layout.py +960 -0
  39. package/marketplace/plugins/litcodex/skills/lit-docx/scripts/slop_lint.py +21 -6
  40. package/marketplace/plugins/litcodex/skills/lit-docx/templates/tonalities/brief.yaml +28 -0
  41. package/marketplace/plugins/litcodex/skills/lit-docx/templates/tonalities/journal.yaml +26 -0
  42. package/marketplace/plugins/litcodex/skills/lit-docx/templates/tonalities/manual.yaml +26 -0
  43. package/marketplace/plugins/litcodex/skills/lit-docx/templates/tonalities/memo.yaml +27 -0
  44. package/marketplace/plugins/litcodex/skills/lit-docx/templates/tonalities/proposal.yaml +27 -0
  45. package/marketplace/plugins/litcodex/skills/lit-docx/templates/tonalities/report.yaml +27 -0
  46. package/marketplace/plugins/litcodex/skills/lit-pptx/SKILL.md +12 -11
  47. package/marketplace/plugins/litcodex/skills/lit-pptx/pretendard-font/public/static/Pretendard-Bold.otf +0 -0
  48. package/marketplace/plugins/litcodex/skills/lit-pptx/pretendard-font/public/static/Pretendard-Regular.otf +0 -0
  49. package/marketplace/plugins/litcodex/skills/lit-pptx/references/anti-slop-checklist.md +33 -29
  50. package/marketplace/plugins/litcodex/skills/lit-pptx/references/authoring-guide.md +11 -2
  51. package/marketplace/plugins/litcodex/skills/lit-pptx/references/density-and-fill.md +179 -0
  52. package/marketplace/plugins/litcodex/skills/lit-pptx/references/design-system-azure.md +1 -1
  53. package/marketplace/plugins/litcodex/skills/lit-pptx/references/direction-step.md +203 -0
  54. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/01-pitch-signal-ko.md +185 -0
  55. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/02-pitch-studio-en.md +162 -0
  56. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/03-business-review-ledger-ko.md +229 -0
  57. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/04-research-talk-paper-en.md +212 -0
  58. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/05-research-keynote-night-ko.md +191 -0
  59. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/06-lecture-chalk-ko.md +175 -0
  60. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/07-data-review-night-en.md +241 -0
  61. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/08-field-report-atlas-ko.md +168 -0
  62. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/09-briefing-gazette-ko.md +219 -0
  63. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/10-status-update-ledger-en.md +157 -0
  64. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/11-portfolio-studio-ko.md +183 -0
  65. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/12-tutorial-chalk-en.md +176 -0
  66. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/13-status-update-gazette-ko.md +157 -0
  67. package/marketplace/plugins/litcodex/skills/lit-pptx/references/interview-protocol.md +1 -1
  68. package/marketplace/plugins/litcodex/skills/lit-pptx/references/layout-families.md +210 -0
  69. package/marketplace/plugins/litcodex/skills/lit-pptx/references/title-treatments.md +146 -0
  70. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/atlas.md +113 -0
  71. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/chalk.md +115 -0
  72. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/gazette.md +118 -0
  73. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/ledger.md +129 -0
  74. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/night.md +126 -0
  75. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/paper.md +109 -0
  76. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/signal.md +121 -0
  77. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/studio.md +111 -0
  78. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/compile-deck.js +65 -17
  79. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/craft_extras.py +654 -11
  80. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/embed_fonts.py +1 -1
  81. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/inventory.py +32 -2
  82. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/directive-parser.js +2 -2
  83. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/grid-resolver.js +521 -0
  84. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/layout-resolver.js +401 -16
  85. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/markdown-loader.js +6 -4
  86. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/render-adapter-html.js +2 -2
  87. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/render-adapter-pptx.js +498 -145
  88. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/render-pack.js +3558 -0
  89. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/slide-ast.js +54 -6
  90. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/template-registry.js +335 -11
  91. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/office-run.mjs +2 -1
  92. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/qa_deck.py +99 -19
  93. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/validate_pptx.py +6 -1
  94. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/boilerplate_professional.css +6 -6
  95. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/enrolled/AZURE-A2Z/layout-mapping.yaml +1 -1
  96. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/enrolled/AZURE-A2Z/template.yaml +4 -1
  97. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/enrolled/AZURE-PRO/layout-mapping.yaml +1 -1
  98. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/enrolled/AZURE-PRO/template.yaml +4 -1
  99. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/atlas/pack.yaml +105 -0
  100. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/chalk/pack.yaml +110 -0
  101. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/gazette/pack.yaml +105 -0
  102. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/ledger/pack.yaml +106 -0
  103. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/night/pack.yaml +106 -0
  104. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/paper/pack.yaml +111 -0
  105. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/signal/pack.yaml +107 -0
  106. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/studio/pack.yaml +105 -0
  107. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/THIRD_PARTY_NOTICES +1 -1
  108. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/fonts.mjs +6 -6
  109. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/gate.mjs +1 -1
  110. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/stage-qa.mjs +2 -2
  111. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/runtime.md +1 -1
  112. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/stage.md +1 -1
  113. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/style-bibles.md +2 -2
  114. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/treatment.md +1 -1
  115. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/type-and-timing.md +3 -3
  116. package/node_modules/@litcodex/lit-loop/package.json +1 -1
  117. package/package.json +2 -2
  118. package/readme-assets/badge-version.svg +1 -1
  119. package/marketplace/plugins/litcodex/skills/lit-pptx/pretendard-font/public/static/PretendardGOV-Bold.otf +0 -0
  120. package/marketplace/plugins/litcodex/skills/lit-pptx/pretendard-font/public/static/PretendardGOV-Regular.otf +0 -0
@@ -10,6 +10,9 @@ exits non-zero if ANY real defect is found:
10
10
 
11
11
  No LibreOffice / rendering engine required: everything is read from the OOXML
12
12
  via python-pptx. A renderer is needed only for separate visual preview.
13
+
14
+ With --sibling OTHER.pptx (the same source compiled under another tonality) the
15
+ office craft check also fails two decks that draw one skeleton (OF-116).
13
16
  """
14
17
 
15
18
  from __future__ import annotations
@@ -27,7 +30,7 @@ from pptx import Presentation
27
30
  from pptx.dml.color import RGBColor
28
31
  from pptx.enum.shapes import MSO_AUTO_SHAPE_TYPE, MSO_SHAPE_TYPE
29
32
  from pptx.opc.constants import RELATIONSHIP_TYPE as RT
30
- from craft_extras import analyze_craft
33
+ from craft_extras import DISPLAY_FAMILY, GRID_MARGIN, PACK_STAMP, analyze_craft, compare_skeletons, family_of, title_frame
31
34
 
32
35
  ROOT = Path(__file__).resolve().parents[1]
33
36
  VALIDATE = ROOT / "scripts" / "validate_pptx.py"
@@ -93,10 +96,21 @@ def _bbox(shape):
93
96
  return None
94
97
 
95
98
 
96
- def _resolve_bg(shape, idx, filled):
99
+ def _slide_ground(slide) -> tuple[int, int, int]:
100
+ """The slide's own solid background colour, white when it has none."""
101
+ try:
102
+ if slide.background.fill.type == 1:
103
+ return _hex_to_rgb(slide.background.fill.fore_color.rgb) or (255, 255, 255)
104
+ except (AttributeError, TypeError, ValueError):
105
+ pass
106
+ return (255, 255, 255)
107
+
108
+
109
+ def _resolve_bg(shape, idx, filled, ground=(255, 255, 255)):
97
110
  """Effective background for a text shape: its own fill, else the topmost
98
111
  filled shape drawn *behind* it (lower z-order) that contains its centre,
99
- else white. Prevents false positives like white text over a charcoal band."""
112
+ else the slide's own ground. Prevents false positives like white text over a
113
+ charcoal band or light text on a dark slide."""
100
114
  own = _shape_fill_rgb(shape)
101
115
  if own is not None:
102
116
  return own
@@ -111,7 +125,7 @@ def _resolve_bg(shape, idx, filled):
111
125
  best = f_rgb # later (higher idx) wins -> topmost behind text
112
126
  if best is not None:
113
127
  return best
114
- return (255, 255, 255)
128
+ return ground
115
129
 
116
130
 
117
131
  def check_contrast(path: Path) -> dict[str, Any]:
@@ -122,10 +136,11 @@ def check_contrast(path: Path) -> dict[str, Any]:
122
136
  for s_idx, slide in enumerate(prs.slides, start=1):
123
137
  shapes = list(slide.shapes)
124
138
  filled = [(i, rgb, _bbox(sh)) for i, sh in enumerate(shapes) if (rgb := _shape_fill_rgb(sh)) is not None]
139
+ ground = _slide_ground(slide)
125
140
  for idx, shape in enumerate(shapes):
126
141
  if not getattr(shape, "has_text_frame", False):
127
142
  continue
128
- bg = _resolve_bg(shape, idx, filled)
143
+ bg = _resolve_bg(shape, idx, filled, ground)
129
144
  for para in shape.text_frame.paragraphs:
130
145
  for run in para.runs:
131
146
  if not run.text.strip():
@@ -582,11 +597,53 @@ def check_objective_quality(path: Path) -> dict[str, Any]:
582
597
  return {"pass": all(check["pass"] for check in checks.values()), **checks}
583
598
 
584
599
 
600
+ def _pack_frame(slide, width: float, height: float, margin: float):
601
+ """Body frame of a pack slide in inches (x0, y0, x1, y1): beside a side rail, above a bottom
602
+ title, else under the title; inside the grid margin and above the foot strip."""
603
+ title = title_frame(list(slide.shapes))
604
+ x0, y0, x1, y1 = margin, margin, width - margin, min(height - margin, 6.83)
605
+ if title is not None:
606
+ tx0, ty0, tx1, ty1 = _bbox_in(title)
607
+ if title.name == "title@side-rail":
608
+ x0 = tx1 + 0.1
609
+ elif title.name == "title@bottom-anchor":
610
+ y1 = ty0 - 0.1
611
+ else:
612
+ y0 = ty1 + 0.1
613
+ return (x0, y0, x1, max(y0 + 0.1, y1))
614
+
615
+
616
+ def _encloses(outer, inner, tol: float = 0.05) -> bool:
617
+ return (inner is not None and inner[0] >= outer[0] - tol and inner[1] >= outer[1] - tol
618
+ and inner[2] <= outer[2] + tol and inner[3] <= outer[3] + tol)
619
+
620
+
621
+ def _column_extent(boxes) -> float:
622
+ """Area a pack body occupies: each column of blocks from its first top to its last bottom.
623
+
624
+ A pack sizes every text frame to its text, so frame areas alone read a filled column of
625
+ short paragraphs as empty. A column is the set of blocks that overlap by half the narrower
626
+ one; an empty stretch inside a column is OF-109's to judge.
627
+ """
628
+ columns: list[list[float]] = []
629
+ for x0, y0, x1, y1 in sorted(boxes):
630
+ for c in columns:
631
+ if min(c[2], x1) - max(c[0], x0) >= 0.5 * min(c[2] - c[0], x1 - x0):
632
+ c[:] = [min(c[0], x0), min(c[1], y0), max(c[2], x1), max(c[3], y1)]
633
+ break
634
+ else:
635
+ columns.append([x0, y0, x1, y1])
636
+ return sum((c[2] - c[0]) * (c[3] - c[1]) for c in columns)
637
+
638
+
585
639
  def check_content_quality(path: Path) -> dict[str, Any]:
586
640
  """Measure usable content coverage and reject table-only narratives."""
587
641
  deck = Presentation(str(path))
588
642
  width = deck.slide_width / 914400.0
643
+ height = deck.slide_height / 914400.0
589
644
  content_area = max(1.0, (width - 1.4) * 4.8)
645
+ stamp = PACK_STAMP.search(deck.core_properties.subject or "")
646
+ margin = GRID_MARGIN[960 if round(width * 72) == 960 else 720].get(stamp.group(3), 48.0) / 72 if stamp else 0.7
590
647
  inspected = []
591
648
  violations = []
592
649
  for number, slide in enumerate(deck.slides, 1):
@@ -607,15 +664,28 @@ def check_content_quality(path: Path) -> dict[str, Any]:
607
664
  has_line = _hex_to_rgb(shape.line.color.rgb) is not None
608
665
  except (TypeError, AttributeError):
609
666
  has_line = False
610
- if has_line and shape.width / 914400.0 >= 0.25 and shape.height / 914400.0 >= 0.25:
667
+ outline = _bbox_in(shape)
668
+ # A hairline drawn around a text block, picture, table or chart is that content's frame.
669
+ framed = any(other is not shape and (_shape_kind(other) or other.shape_type == MSO_SHAPE_TYPE.CHART)
670
+ and _encloses(outline, _bbox_in(other)) for other in shapes)
671
+ if has_line and not framed and shape.width / 914400.0 >= 0.25 and shape.height / 914400.0 >= 0.25:
611
672
  violations.append({"slide": number, "kind": "empty-shape", "fix": "Remove the unlabelled outlined box or put meaningful content inside it."})
612
- top_title = any(
613
- getattr(shape, "has_text_frame", False) and shape.text.strip()
614
- and shape.top / 914400.0 < 1.35 and shape.height / 914400.0 >= 0.25
615
- for shape in shapes
616
- )
617
- if not top_title: # cover, divider and closing slides have different composition
618
- continue
673
+ family = family_of(shapes)
674
+ if family:
675
+ if DISPLAY_FAMILY.search(family):
676
+ continue # a pack's cover, section, statement, quote or full picture
677
+ bx0, by0, bx1, by1 = _pack_frame(slide, width, height, margin)
678
+ else:
679
+ top_title = any(
680
+ getattr(shape, "has_text_frame", False) and shape.text.strip()
681
+ and shape.top / 914400.0 < 1.35 and shape.height / 914400.0 >= 0.25
682
+ for shape in shapes
683
+ )
684
+ if not top_title: # cover, divider and closing slides have different composition
685
+ continue
686
+ bx0, by0, bx1, by1 = 0.7, 1.8, width - 0.7, 6.6
687
+ frame_area = max(1.0, (bx1 - bx0) * (by1 - by0)) if family else content_area
688
+ title = title_frame(shapes) if family else None
619
689
  text_boxes = [_bbox_in(shape) for shape in shapes if _shape_kind(shape) == "text"]
620
690
  cards = []
621
691
  for shape in shapes:
@@ -628,12 +698,13 @@ def check_content_quality(path: Path) -> dict[str, Any]:
628
698
  cards.append(card_box)
629
699
  coverage = 0.0
630
700
  kinds = set()
701
+ clipped = []
631
702
  for shape in shapes:
632
703
  bounds = _bbox_in(shape)
633
- if bounds is None:
704
+ if bounds is None or shape is title or shape.name.startswith("lit-notice"):
634
705
  continue
635
706
  x0, y0, x1, y1 = bounds
636
- if y1 <= 1.8 or y0 >= 6.6:
707
+ if y1 <= by0 or y0 >= by1:
637
708
  continue
638
709
  kind = _shape_kind(shape)
639
710
  if shape.shape_type == MSO_SHAPE_TYPE.CHART:
@@ -645,8 +716,12 @@ def check_content_quality(path: Path) -> dict[str, Any]:
645
716
  continue
646
717
  if kind:
647
718
  kinds.add(kind)
648
- coverage += max(0, min(x1, width - 0.7) - max(x0, 0.7)) * max(0, min(y1, 6.6) - max(y0, 1.8))
649
- ratio = min(1.0, coverage / content_area)
719
+ coverage += max(0, min(x1, bx1) - max(x0, bx0)) * max(0, min(y1, by1) - max(y0, by0))
720
+ if min(x1, bx1) > max(x0, bx0):
721
+ clipped.append((max(x0, bx0), max(y0, by0), min(x1, bx1), min(y1, by1)))
722
+ if family:
723
+ coverage = _column_extent(clipped)
724
+ ratio = min(1.0, coverage / frame_area)
650
725
  inspected.append({"slide": number, "fill_ratio": round(ratio, 3), "kinds": sorted(kinds)})
651
726
  if ratio < 0.42:
652
727
  violations.append({"slide": number, "kind": "underfilled", "fill_ratio": round(ratio, 3), "fix": "Expand the chart, KPI cards, flow, image or concise body into the content area."})
@@ -711,7 +786,7 @@ def run_validate(pptx: Path) -> dict[str, Any]:
711
786
 
712
787
 
713
788
  # ── gate ───────────────────────────────────────────────────────────────────
714
- def qa(pptx: Path) -> dict[str, Any]:
789
+ def qa(pptx: Path, sibling: Path | None = None) -> dict[str, Any]:
715
790
  validate_report = run_validate(pptx)
716
791
  inv_summary = summarize_inventory(load_inventory_issues(pptx))
717
792
  contrast = check_contrast(pptx)
@@ -720,6 +795,10 @@ def qa(pptx: Path) -> dict[str, Any]:
720
795
  objective = check_objective_quality(pptx)
721
796
  content_quality = check_content_quality(pptx)
722
797
  office_craft = analyze_craft(Presentation(pptx))
798
+ # The same source under another tonality, when given: the two decks must not share one skeleton (OF-116).
799
+ if sibling is not None:
800
+ office_craft["findings"] += compare_skeletons(pptx, sibling)
801
+ office_craft["pass"] = not any(f["severity"] == "HIGH" for f in office_craft["findings"])
723
802
 
724
803
  reasons: list[str] = []
725
804
  if not validate_report.get("pass", False):
@@ -785,8 +864,9 @@ def qa(pptx: Path) -> dict[str, Any]:
785
864
  def main(argv: list[str] | None = None) -> int:
786
865
  parser = argparse.ArgumentParser(description="Honest renderer-agnostic QA gate for PPTX decks.")
787
866
  parser.add_argument("pptx", type=Path)
867
+ parser.add_argument("--sibling", type=Path, help="the same source compiled under another tonality (OF-116)")
788
868
  args = parser.parse_args(argv)
789
- report = qa(args.pptx.resolve())
869
+ report = qa(args.pptx.resolve(), args.sibling.resolve() if args.sibling else None)
790
870
  print(json.dumps(report, ensure_ascii=False, indent=2))
791
871
  return 0 if report["pass"] else 1
792
872
 
@@ -109,6 +109,9 @@ def _slide_has_title(slide, slide_height: int | None) -> bool:
109
109
  placeholder = getattr(shape, "placeholder_format", None)
110
110
  if placeholder and placeholder.type == PP_PLACEHOLDER.TITLE and _shape_text(shape):
111
111
  return True
112
+ # A pack deck names its title frame by treatment; a section or bottom title sits low by design.
113
+ if any(str(getattr(shape, "name", "")).startswith("title@") and _shape_text(shape) for shape in slide.shapes):
114
+ return True
112
115
  text_shapes = []
113
116
  for shape in slide.shapes:
114
117
  if not getattr(shape, "has_text_frame", False):
@@ -166,7 +169,9 @@ def lint(path: str | Path) -> dict[str, Any]:
166
169
  default_font_hits.append(f"slide {slide_idx}: {font_name}")
167
170
 
168
171
  last_slide_text = "\n".join(_shape_text(shape) for shape in prs.slides[-1].shapes if getattr(shape, "has_text_frame", False)).lower() if prs.slides else ""
169
- has_source_note = "source:" in last_slide_text or "출처" in last_slide_text
172
+ # A closing references page is the deck's source note at full length.
173
+ has_source_note = "source:" in last_slide_text or "출처" in last_slide_text or bool(
174
+ re.search(r"^\s*(?:references|참고\s*문헌)\s*$", last_slide_text, re.MULTILINE))
170
175
 
171
176
  failures = {
172
177
  "missing_titles": bool(missing_titles),
@@ -4,32 +4,32 @@
4
4
  @font-face {
5
5
  font-family: "Pretendard";
6
6
  font-weight: 300;
7
- src: url("../pretendard-font/public/static/PretendardGOV-Light.otf") format("opentype");
7
+ src: url("../pretendard-font/public/static/Pretendard-Light.otf") format("opentype");
8
8
  }
9
9
  @font-face {
10
10
  font-family: "Pretendard";
11
11
  font-weight: 400;
12
- src: url("../pretendard-font/public/static/PretendardGOV-Regular.otf") format("opentype");
12
+ src: url("../pretendard-font/public/static/Pretendard-Regular.otf") format("opentype");
13
13
  }
14
14
  @font-face {
15
15
  font-family: "Pretendard";
16
16
  font-weight: 500;
17
- src: url("../pretendard-font/public/static/PretendardGOV-Medium.otf") format("opentype");
17
+ src: url("../pretendard-font/public/static/Pretendard-Medium.otf") format("opentype");
18
18
  }
19
19
  @font-face {
20
20
  font-family: "Pretendard";
21
21
  font-weight: 600;
22
- src: url("../pretendard-font/public/static/PretendardGOV-SemiBold.otf") format("opentype");
22
+ src: url("../pretendard-font/public/static/Pretendard-SemiBold.otf") format("opentype");
23
23
  }
24
24
  @font-face {
25
25
  font-family: "Pretendard";
26
26
  font-weight: 700;
27
- src: url("../pretendard-font/public/static/PretendardGOV-Bold.otf") format("opentype");
27
+ src: url("../pretendard-font/public/static/Pretendard-Bold.otf") format("opentype");
28
28
  }
29
29
  @font-face {
30
30
  font-family: "Pretendard";
31
31
  font-weight: 800;
32
- src: url("../pretendard-font/public/static/PretendardGOV-ExtraBold.otf") format("opentype");
32
+ src: url("../pretendard-font/public/static/Pretendard-ExtraBold.otf") format("opentype");
33
33
  }
34
34
 
35
35
  :root {
@@ -1,5 +1,5 @@
1
1
  # Layout Mapping — AZURE-PRO (16:9, 13.333 x 7.5 in). Positions in inches.
2
- # render_style: azure → body→cards, kpi-table→KPI cards, cover title **emphasis**.
2
+ # rich-blocks capability (template.yaml pack:) → body→cards, kpi-table→KPI cards, cover title **emphasis**.
3
3
 
4
4
  layouts:
5
5
  cover:
@@ -1,7 +1,6 @@
1
1
  name: AZURE-A2Z
2
2
  version: "1.0.0"
3
3
  label: "Azure Professional (에이투지체 / A2Z)"
4
- render_style: azure
5
4
  description: "Flagship SOTA blue-and-white deck — 16:9 widescreen, Pretendard, geometric gradient accents, rounded tint cards, numbered chips, KPI cards. Pro-designer aesthetic."
6
5
 
7
6
  fonts:
@@ -35,3 +34,7 @@ global_typography:
35
34
  bullet_char: "•"
36
35
  bullet_color: "1D4ED8"
37
36
  section_accent: "1D4ED8"
37
+
38
+ # Read as a legacy pack: what this template can draw beyond plain text regions.
39
+ pack:
40
+ capabilities: [rich-blocks, recolor, font-swap, mesh-background]
@@ -1,5 +1,5 @@
1
1
  # Layout Mapping — AZURE-PRO (16:9, 13.333 x 7.5 in). Positions in inches.
2
- # render_style: azure → body→cards, kpi-table→KPI cards, cover title **emphasis**.
2
+ # rich-blocks capability (template.yaml pack:) → body→cards, kpi-table→KPI cards, cover title **emphasis**.
3
3
 
4
4
  layouts:
5
5
  cover:
@@ -1,7 +1,6 @@
1
1
  name: AZURE-PRO
2
2
  version: "1.0.0"
3
3
  label: "Azure Professional"
4
- render_style: azure
5
4
  description: "Flagship SOTA blue-and-white deck — 16:9 widescreen, Pretendard, geometric gradient accents, rounded tint cards, numbered chips, KPI cards. Pro-designer aesthetic."
6
5
 
7
6
  fonts:
@@ -35,3 +34,7 @@ global_typography:
35
34
  bullet_char: "•"
36
35
  bullet_color: "1D4ED8"
37
36
  section_accent: "1D4ED8"
37
+
38
+ # Read as a legacy pack: what this template can draw beyond plain text regions.
39
+ pack:
40
+ capabilities: [rich-blocks, recolor, font-swap, mesh-background]
@@ -0,0 +1,105 @@
1
+ # Atlas: image-led pages. Pictures run to the edge and carry the colour; titles sit on a dark
2
+ # panel over the picture or under it; captions stay short. Needs real images: without them the
3
+ # frames stand empty.
4
+ id: atlas
5
+ name: Atlas
6
+ version: "1.0.0"
7
+ intent: "Image-led decks: products, portfolios, places, field work."
8
+ canvas: ["16:9", "4:3"]
9
+
10
+ # Pretendard by default; the A2Z map below applies only when the source asks (faces: a2z).
11
+ faces:
12
+ display: Pretendard Regular
13
+ title: Pretendard Bold
14
+ body: Pretendard Regular
15
+ label: Pretendard Regular
16
+ numeral: Pretendard Regular
17
+ faces-pretendard-only:
18
+ display: Pretendard Regular
19
+ title: Pretendard Bold
20
+ body: Pretendard Regular
21
+ label: Pretendard Regular
22
+ numeral: Pretendard Regular
23
+ faces-a2z:
24
+ display: A2Z Light
25
+ title: Pretendard Bold
26
+ body: Pretendard Regular
27
+ label: Pretendard Regular
28
+ numeral: A2Z Light
29
+
30
+ palette:
31
+ ground: "#FFFFFF"
32
+ surface: "#F3F4F5"
33
+ ink: "#1A1D21"
34
+ ink-muted: "#555B63"
35
+ line: "#D6D9DD"
36
+ accent: "#2B4C7E"
37
+ accent-deep: "#1B2F4E"
38
+ accent-tint: "#E6ECF4"
39
+ field: "#1A1D21"
40
+ on-field: "#FFFFFF"
41
+ positive: "#1E7A3F"
42
+ negative: "#B3261E"
43
+ series: ["#2B4C7E", "#555B63", "#8A6A2E", "#3E7A5A"]
44
+
45
+ ramp: reading
46
+ hero: false
47
+ type-voice:
48
+ title-tracking: 0
49
+ display-tracking: -1
50
+ latin-case: sentence
51
+ figures: proportional
52
+
53
+ density: 10
54
+ variance: 7
55
+ radius: 0
56
+ edge: fill
57
+
58
+ treatments: [overlay, bottom-anchor, side-rail, top-plain-large, statement]
59
+ role-defaults:
60
+ content: side-rail
61
+ data: top-plain-large
62
+ data-takeaway: bottom-anchor
63
+ sequence: top-plain-large
64
+ image: overlay
65
+ statement: statement
66
+ reference: side-rail
67
+ definition: side-rail
68
+
69
+ decoration: [caption-band, hairline-rule, colour-field]
70
+ layout-families: [image-full, image-split, photo-grid, figure-pair, asymmetric-feature, kpi-row, comparison, timeline, text-column, statement]
71
+ # Display slides: the device a type-led cover, a statement, a big number and a closing's next step
72
+ # are drawn with (see references/layout-families.md, "Display slides").
73
+ display:
74
+ cover: plate
75
+ statement: drench
76
+ number: tint
77
+ closing: band
78
+ covers: [cover-full-image, cover-split-image, cover-typographic]
79
+ sections: [section-image, section-field]
80
+ closings: [closing-contact-split, closing-ask]
81
+
82
+ table:
83
+ style: light-grid
84
+ header: none
85
+ header-ink: ink
86
+ rules: rows
87
+ banding: none
88
+ numbers: right-tabular
89
+ totals: bold
90
+ chart:
91
+ gridlines: hairline
92
+ labels: direct
93
+ highlight: accent-on-muted
94
+ annotation: off
95
+ image:
96
+ bleed: allowed
97
+ crop: allowed
98
+ frame: none
99
+
100
+ fill-order: [anchor-visual, change-family, distribute, step-up]
101
+ avoid:
102
+ - text placed straight on photographs
103
+ - images in card frames
104
+ - more than three images in one row
105
+ - grey placeholder boxes in a delivered deck
@@ -0,0 +1,110 @@
1
+ # Chalk: a teaching deck. One concept per slide, numbered steps, a fenced box for the definition
2
+ # or the usual mistake, a warm rust accent on what is being taught. Not for decision decks, where
3
+ # the step rhythm adds slides without adding content.
4
+ id: chalk
5
+ name: Chalk
6
+ version: "1.0.0"
7
+ intent: "Teaching decks: steps, worked examples, definitions."
8
+ canvas: ["16:9", "4:3"]
9
+
10
+ # Pretendard by default; the A2Z map below applies only when the source asks (faces: a2z).
11
+ faces:
12
+ display: Pretendard Bold
13
+ title: Pretendard Bold
14
+ body: Pretendard Regular
15
+ label: Pretendard Regular
16
+ numeral: Pretendard Bold
17
+ faces-pretendard-only:
18
+ display: Pretendard Bold
19
+ title: Pretendard Bold
20
+ body: Pretendard Regular
21
+ label: Pretendard Regular
22
+ numeral: Pretendard Bold
23
+ faces-a2z:
24
+ display: A2Z Bold
25
+ title: A2Z Bold
26
+ body: Pretendard Regular
27
+ label: Pretendard Regular
28
+ numeral: A2Z Black
29
+
30
+ palette:
31
+ ground: "#FAFBFC"
32
+ surface: "#EEF2F5"
33
+ ink: "#1F2933"
34
+ ink-muted: "#4E5A66"
35
+ line: "#CBD3DA"
36
+ accent: "#9A3412"
37
+ accent-deep: "#6B2409"
38
+ accent-tint: "#FCEBE0"
39
+ field: "#1F3B33"
40
+ on-field: "#FFFFFF"
41
+ positive: "#1E7A3F"
42
+ negative: "#B3261E"
43
+ series: ["#9A3412", "#1F3B33", "#4E5A66", "#2E6A8E"]
44
+
45
+ ramp: reading
46
+ hero: false
47
+ type-voice:
48
+ title-tracking: -1
49
+ display-tracking: -1
50
+ latin-case: sentence
51
+ figures: proportional
52
+
53
+ density: 10
54
+ variance: 6
55
+ radius: 6
56
+ edge: fill
57
+
58
+ treatments: [kicker-numeral, top-rule, side-rail, statement]
59
+ role-defaults:
60
+ content: top-rule
61
+ data: top-rule
62
+ data-takeaway: side-rail
63
+ sequence: kicker-numeral
64
+ image: side-rail
65
+ statement: statement
66
+ reference: top-rule
67
+ definition: side-rail
68
+
69
+ # A comparison is drawn with its criteria on the board rail.
70
+ structure:
71
+ comparison: side-rail
72
+
73
+ decoration: [accent-rule, mark-underline, rail-fill, numeral]
74
+ # The rail under a side title is the board itself: the dark field, the title in white.
75
+ rail: field
76
+ layout-families: [step-diagram, process, method, sidebar-note, comparison, image-split, quote, agenda, statement, text-column, table-insight]
77
+ # Display slides: the device a type-led cover, a statement, a big number and a closing's next step
78
+ # are drawn with (see references/layout-families.md, "Display slides").
79
+ display:
80
+ cover: rail
81
+ statement: drench
82
+ number: tint
83
+ closing: box
84
+ covers: [cover-rail, cover-typographic, cover-numeral]
85
+ sections: [section-numeral, section-rail]
86
+ closings: [closing-summary-list, closing-ask]
87
+
88
+ table:
89
+ style: header-fill
90
+ header: accent-tint
91
+ header-ink: accent-deep
92
+ rules: rows
93
+ banding: none
94
+ numbers: right-tabular
95
+ totals: bold
96
+ chart:
97
+ gridlines: hairline
98
+ labels: direct
99
+ highlight: accent-on-muted
100
+ annotation: on
101
+ image:
102
+ bleed: side-only
103
+ crop: none
104
+ frame: none
105
+
106
+ fill-order: [distribute, step-up, change-family, anchor-visual]
107
+ avoid:
108
+ - more than one marked term per slide
109
+ - numerals on points that are not a sequence
110
+ - definitions buried in bullets instead of the sidebar
@@ -0,0 +1,105 @@
1
+ # Gazette: a Korean briefing read at a desk. A slate band holds the content titles, a boxed
2
+ # one-line conclusion opens the page and itemised evidence fills two reading-size columns; one red
3
+ # key line is the only accent. Too dense to present aloud.
4
+ id: gazette
5
+ name: Gazette
6
+ version: "1.0.0"
7
+ intent: "Korean briefing decks that are read, not presented."
8
+ canvas: ["16:9", "4:3"]
9
+
10
+ # Pretendard by default; the A2Z map below applies only when the source asks (faces: a2z).
11
+ faces:
12
+ display: Pretendard Bold
13
+ title: Pretendard Bold
14
+ body: Pretendard Regular
15
+ label: Pretendard Regular
16
+ numeral: Pretendard Bold
17
+ faces-pretendard-only:
18
+ display: Pretendard Bold
19
+ title: Pretendard Bold
20
+ body: Pretendard Regular
21
+ label: Pretendard Regular
22
+ numeral: Pretendard Bold
23
+ faces-a2z:
24
+ display: A2Z Bold
25
+ title: Pretendard Bold
26
+ body: Pretendard Regular
27
+ label: Pretendard Regular
28
+ numeral: A2Z Bold
29
+
30
+ palette:
31
+ ground: "#FFFFFF"
32
+ surface: "#F1F4F8"
33
+ ink: "#1A2230"
34
+ ink-muted: "#4A5568"
35
+ line: "#C8D0DA"
36
+ accent: "#A61B1B"
37
+ accent-deep: "#233A4F"
38
+ accent-tint: "#E8EEF4"
39
+ field: "#233A4F"
40
+ on-field: "#FFFFFF"
41
+ positive: "#1E7A3F"
42
+ negative: "#1A2230"
43
+ series: ["#A61B1B", "#233A4F", "#4A5568", "#7A6A2A"]
44
+
45
+ ramp: reading
46
+ hero: false
47
+ type-voice:
48
+ title-tracking: -1
49
+ display-tracking: -1
50
+ latin-case: sentence
51
+ figures: tabular
52
+
53
+ density: 10
54
+ variance: 4
55
+ radius: 0
56
+ edge: fill+border
57
+
58
+ treatments: [band, top-rule, kicker-numeral, side-rail]
59
+ role-defaults:
60
+ content: band
61
+ data: top-rule
62
+ data-takeaway: side-rail
63
+ sequence: kicker-numeral
64
+ image: side-rail
65
+ statement: band
66
+ reference: top-rule
67
+ definition: side-rail
68
+
69
+ decoration: [header-band, box-outline, hairline-rule, numeral]
70
+ layout-families: [summary-box-list, text-two-column, text-column, ledger-table, table-insight, comparison, timeline, matrix-2x2, agenda, references-appendix]
71
+ # Display slides: the device a type-led cover, a statement, a big number and a closing's next step
72
+ # are drawn with (see references/layout-families.md, "Display slides").
73
+ display:
74
+ cover: band
75
+ number: outline
76
+ closing: box
77
+ index: true
78
+ covers: [cover-band, cover-typographic, cover-index]
79
+ sections: [section-band, section-rule]
80
+ closings: [closing-decision-box, closing-ask]
81
+
82
+ table:
83
+ style: header-fill
84
+ header: field
85
+ header-ink: on-field
86
+ rules: grid
87
+ banding: surface
88
+ numbers: right-tabular
89
+ totals: bold
90
+ chart:
91
+ gridlines: hairline
92
+ labels: direct
93
+ highlight: accent-on-muted
94
+ annotation: off
95
+ image:
96
+ bleed: none
97
+ crop: none
98
+ frame: hairline
99
+
100
+ fill-order: [step-up, distribute, change-family, anchor-visual]
101
+ avoid:
102
+ - English section kickers
103
+ - red for anything but the key line
104
+ - a summary box longer than three lines
105
+ - more than three text families in a row