@litfamily/litgrok 1.0.13 → 1.0.15

package/.grok/skills/lit-pptx/scripts/validate_pptx.py

@@ -55,12 +55,18 @@ def _load_terms() -> tuple[list[str], list[str], bool, bool]:
 def _build_regex(terms: list[str], case_insensitive: bool, whole_word: bool) -> re.Pattern[str] | None:
     if not terms:
         return None
-    escaped = [re.escape(term) for term in terms]
+    # An acronym (RAM, FTO) is a word in capitals: matched as that word, so "diagram" or "program"
+    # does not contain it. Every other term keeps the file's case and word settings.
+    acronyms = [term for term in terms if re.fullmatch(r"[A-Z]{2,5}", term)]
+    escaped = [re.escape(term) for term in terms if term not in acronyms]
     pattern = "|".join(escaped)
-    if whole_word:
+    if whole_word and pattern:
         pattern = rf"(?:(?<=\W)|^)(?:{pattern})(?:(?=\W)|$)"
-    flags = re.IGNORECASE if case_insensitive else 0
-    return re.compile(pattern, flags)
+    if case_insensitive and pattern:
+        pattern = f"(?i:{pattern})"
+    if acronyms:
+        pattern = "|".join(filter(None, [pattern, rf"(?<![A-Za-z])(?:{'|'.join(map(re.escape, acronyms))})(?![A-Za-z])"]))
+    return re.compile(pattern)
 
 
 def _shape_text(shape) -> str:
@@ -103,6 +109,10 @@ def _slide_has_title(slide, slide_height: int | None) -> bool:
     title_shape = getattr(slide.shapes, "title", None)
     if title_shape is not None and _shape_text(title_shape):
         return True
+    # A tonality deck names its title frame by treatment (title@side-rail, title@bottom-anchor, ...),
+    # wherever the treatment puts it on the slide.
+    if any(str(getattr(shape, "name", "")).startswith("title@") and _shape_text(shape) for shape in slide.shapes):
+        return True
     for shape in slide.shapes:
         if not getattr(shape, "is_placeholder", False):
             continue
@@ -166,7 +176,9 @@ def lint(path: str | Path) -> dict[str, Any]:
                 default_font_hits.append(f"slide {slide_idx}: {font_name}")
 
     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 ""
-    has_source_note = "source:" in last_slide_text or "출처" in last_slide_text
+    # A closing references page is the deck's source note in its long form.
+    has_source_note = "source:" in last_slide_text or "출처" in last_slide_text or bool(
+        re.search(r"^\s*(references|참고\s*문헌)\s*$", last_slide_text, re.MULTILINE))
 
     failures = {
         "missing_titles": bool(missing_titles),

package/.grok/skills/lit-pptx/templates/boilerplate_professional.css

@@ -4,32 +4,32 @@
 @font-face {
   font-family: "Pretendard";
   font-weight: 300;
-  src: url("../pretendard-font/public/static/PretendardGOV-Light.otf") format("opentype");
+  src: url("../pretendard-font/public/static/Pretendard-Light.otf") format("opentype");
 }
 @font-face {
   font-family: "Pretendard";
   font-weight: 400;
-  src: url("../pretendard-font/public/static/PretendardGOV-Regular.otf") format("opentype");
+  src: url("../pretendard-font/public/static/Pretendard-Regular.otf") format("opentype");
 }
 @font-face {
   font-family: "Pretendard";
   font-weight: 500;
-  src: url("../pretendard-font/public/static/PretendardGOV-Medium.otf") format("opentype");
+  src: url("../pretendard-font/public/static/Pretendard-Medium.otf") format("opentype");
 }
 @font-face {
   font-family: "Pretendard";
   font-weight: 600;
-  src: url("../pretendard-font/public/static/PretendardGOV-SemiBold.otf") format("opentype");
+  src: url("../pretendard-font/public/static/Pretendard-SemiBold.otf") format("opentype");
 }
 @font-face {
   font-family: "Pretendard";
   font-weight: 700;
-  src: url("../pretendard-font/public/static/PretendardGOV-Bold.otf") format("opentype");
+  src: url("../pretendard-font/public/static/Pretendard-Bold.otf") format("opentype");
 }
 @font-face {
   font-family: "Pretendard";
   font-weight: 800;
-  src: url("../pretendard-font/public/static/PretendardGOV-ExtraBold.otf") format("opentype");
+  src: url("../pretendard-font/public/static/Pretendard-ExtraBold.otf") format("opentype");
 }
 
 :root {

package/.grok/skills/lit-pptx/templates/enrolled/AZURE-A2Z/layout-mapping.yaml

@@ -1,5 +1,5 @@
 # Layout Mapping — AZURE-PRO (16:9, 13.333 x 7.5 in). Positions in inches.
-# render_style: azure → body→cards, kpi-table→KPI cards, cover title **emphasis**.
+# rich-blocks capability (template.yaml pack:) → body→cards, kpi-table→KPI cards, cover title **emphasis**.
 
 layouts:
   cover:

package/.grok/skills/lit-pptx/templates/enrolled/AZURE-A2Z/template.yaml

@@ -1,7 +1,6 @@
 name: AZURE-A2Z
 version: "1.0.0"
 label: "Azure Professional (에이투지체 / A2Z)"
-render_style: azure
 description: "Flagship SOTA blue-and-white deck — 16:9 widescreen, Pretendard, geometric gradient accents, rounded tint cards, numbered chips, KPI cards. Pro-designer aesthetic."
 
 fonts:
@@ -35,3 +34,7 @@ global_typography:
   bullet_char: "•"
   bullet_color: "1D4ED8"
   section_accent: "1D4ED8"
+
+# Read as a legacy pack: what this template can draw beyond plain text regions.
+pack:
+  capabilities: [rich-blocks, recolor, font-swap, mesh-background]

package/.grok/skills/lit-pptx/templates/enrolled/AZURE-PRO/layout-mapping.yaml

@@ -1,5 +1,5 @@
 # Layout Mapping — AZURE-PRO (16:9, 13.333 x 7.5 in). Positions in inches.
-# render_style: azure → body→cards, kpi-table→KPI cards, cover title **emphasis**.
+# rich-blocks capability (template.yaml pack:) → body→cards, kpi-table→KPI cards, cover title **emphasis**.
 
 layouts:
   cover:

package/.grok/skills/lit-pptx/templates/enrolled/AZURE-PRO/template.yaml

@@ -1,7 +1,6 @@
 name: AZURE-PRO
 version: "1.0.0"
 label: "Azure Professional"
-render_style: azure
 description: "Flagship SOTA blue-and-white deck — 16:9 widescreen, Pretendard, geometric gradient accents, rounded tint cards, numbered chips, KPI cards. Pro-designer aesthetic."
 
 fonts:
@@ -35,3 +34,7 @@ global_typography:
   bullet_char: "•"
   bullet_color: "1D4ED8"
   section_accent: "1D4ED8"
+
+# Read as a legacy pack: what this template can draw beyond plain text regions.
+pack:
+  capabilities: [rich-blocks, recolor, font-swap, mesh-background]

package/.grok/skills/lit-pptx/templates/tonalities/atlas/pack.yaml

@@ -0,0 +1,99 @@
+# Atlas: pictures lead and text follows. Photographs bleed to the edge, titles sit on dark panels
+# or under large images, and the images supply most of the colour. A poor fit when real pictures
+# are scarce, because the layouts become empty frames.
+id: atlas
+name: Atlas
+version: "1.0.0"
+intent: "Image-led decks: products, portfolios, places, field work."
+canvas: ["16:9", "4:3"]
+
+# LitGrok bundles Pretendard Regular and Bold only: title range comes from size, colour and placement.
+faces:
+  display: Pretendard Regular
+  title: Pretendard Bold
+  body: Pretendard Regular
+  label: Pretendard Regular
+  numeral: Pretendard Regular
+faces-pretendard-only:
+  display: Pretendard Regular
+  title: Pretendard Bold
+  body: Pretendard Regular
+  label: Pretendard Regular
+  numeral: Pretendard Regular
+
+palette:
+  ground: "#FFFFFF"
+  surface: "#F3F4F5"
+  ink: "#1A1D21"
+  ink-muted: "#555B63"
+  line: "#D6D9DD"
+  accent: "#2B4C7E"
+  accent-deep: "#1B2F4E"
+  accent-tint: "#E6ECF4"
+  field: "#1A1D21"
+  on-field: "#FFFFFF"
+  positive: "#1E7A3F"
+  negative: "#B3261E"
+  series: ["#2B4C7E", "#555B63", "#8A6A2E", "#3E7A5A"]
+
+ramp: reading
+hero: false
+type-voice:
+  title-tracking: 0
+  display-tracking: -1
+  latin-case: sentence
+  figures: proportional
+
+density: 10
+variance: 7
+radius: 0
+edge: fill
+
+treatments: [overlay, bottom-anchor, side-rail, top-plain-large, statement]
+role-defaults:
+  content: side-rail
+  data: top-plain-large
+  data-takeaway: bottom-anchor
+  sequence: top-plain-large
+  image: overlay
+  statement: statement
+  reference: side-rail
+  definition: side-rail
+
+decoration: [caption-band, hairline-rule, colour-field]
+layout-families: [image-full, image-split, photo-grid, figure-pair, asymmetric-feature, kpi-row, comparison, timeline, text-column, statement]
+# Display slides: how a type-led cover, a statement, a big number and a closing's next step are
+# drawn under this pack (references/layout-families.md, "Display slides").
+display:
+  cover: plate
+  statement: drench
+  number: tint
+  closing: band
+covers: [cover-full-image, cover-split-image, cover-typographic]
+sections: [section-image, section-field]
+closings: [closing-contact-split, closing-ask]
+
+table:
+  style: light-grid
+  header: none
+  header-ink: ink
+  rules: rows
+  banding: none
+  numbers: right-tabular
+  totals: bold
+chart:
+  gridlines: hairline
+  labels: direct
+  highlight: accent-on-muted
+  annotation: off
+image:
+  bleed: allowed
+  crop: allowed
+  frame: none
+
+fill-order: [anchor-visual, change-family, distribute, step-up]
+avoid:
+  - text placed straight on photographs
+  - images in card frames
+  - more than three images in one row
+  - grey placeholder boxes in a delivered deck

package/.grok/skills/lit-pptx/templates/tonalities/chalk/pack.yaml

@@ -0,0 +1,104 @@
+# Chalk: a lesson laid out in order. Numbered steps, one marked idea per slide, a fenced box for the
+# definition or the usual mistake, rounded surfaces and a warm rust accent for what is being taught.
+# A poor fit for decision decks, where the step rhythm reads as filler.
+id: chalk
+name: Chalk
+version: "1.0.0"
+intent: "Teaching decks: steps, worked examples, definitions."
+canvas: ["16:9", "4:3"]
+
+# LitGrok bundles Pretendard Regular and Bold only: title range comes from size, colour and placement.
+faces:
+  display: Pretendard Bold
+  title: Pretendard Bold
+  body: Pretendard Regular
+  label: Pretendard Regular
+  numeral: Pretendard Bold
+faces-pretendard-only:
+  display: Pretendard Bold
+  title: Pretendard Bold
+  body: Pretendard Regular
+  label: Pretendard Regular
+  numeral: Pretendard Bold
+
+palette:
+  ground: "#FAFBFC"
+  surface: "#EEF2F5"
+  ink: "#1F2933"
+  ink-muted: "#4E5A66"
+  line: "#CBD3DA"
+  accent: "#9A3412"
+  accent-deep: "#6B2409"
+  accent-tint: "#FCEBE0"
+  field: "#1F3B33"
+  on-field: "#FFFFFF"
+  positive: "#1E7A3F"
+  negative: "#B3261E"
+  series: ["#9A3412", "#1F3B33", "#4E5A66", "#2E6A8E"]
+
+ramp: reading
+hero: false
+type-voice:
+  title-tracking: -1
+  display-tracking: -1
+  latin-case: sentence
+  figures: proportional
+
+density: 10
+variance: 6
+radius: 6
+edge: fill
+
+treatments: [kicker-numeral, top-rule, side-rail, statement]
+role-defaults:
+  content: top-rule
+  data: top-rule
+  data-takeaway: side-rail
+  sequence: kicker-numeral
+  image: side-rail
+  statement: statement
+  reference: top-rule
+  definition: side-rail
+
+# A comparison is drawn with its criteria on the board rail.
+structure:
+  comparison: side-rail
+
+decoration: [accent-rule, mark-underline, rail-fill, numeral]
+# Under a side title the rail is the board: a dark field with the title set in white.
+rail: field
+layout-families: [step-diagram, process, method, sidebar-note, comparison, image-split, quote, agenda, statement, text-column, table-insight]
+# Display slides: how a type-led cover, a statement, a big number and a closing's next step are
+# drawn under this pack (references/layout-families.md, "Display slides").
+display:
+  cover: rail
+  statement: drench
+  number: tint
+  closing: box
+covers: [cover-rail, cover-typographic, cover-numeral]
+sections: [section-numeral, section-rail]
+closings: [closing-summary-list, closing-ask]
+
+table:
+  style: header-fill
+  header: accent-tint
+  header-ink: accent-deep
+  rules: rows
+  banding: none
+  numbers: right-tabular
+  totals: bold
+chart:
+  gridlines: hairline
+  labels: direct
+  highlight: accent-on-muted
+  annotation: on
+image:
+  bleed: side-only
+  crop: none
+  frame: none
+
+fill-order: [distribute, step-up, change-family, anchor-visual]
+avoid:
+  - more than one marked term per slide
+  - numerals on points that are not a sequence
+  - definitions buried in bullets instead of the sidebar

package/.grok/skills/lit-pptx/templates/tonalities/gazette/pack.yaml

@@ -0,0 +1,99 @@
+# Gazette: a Korean briefing paper turned into slides. A slate band holds the title on content pages,
+# a boxed one-line conclusion opens the body, and itemised evidence runs in two columns at reading
+# size with one red key line. A poor fit for a live talk: what helps a reader swamps a listener.
+id: gazette
+name: Gazette
+version: "1.0.0"
+intent: "Korean briefing decks that are read, not presented."
+canvas: ["16:9", "4:3"]
+
+# LitGrok bundles Pretendard Regular and Bold only: title range comes from size, colour and placement.
+faces:
+  display: Pretendard Bold
+  title: Pretendard Bold
+  body: Pretendard Regular
+  label: Pretendard Regular
+  numeral: Pretendard Bold
+faces-pretendard-only:
+  display: Pretendard Bold
+  title: Pretendard Bold
+  body: Pretendard Regular
+  label: Pretendard Regular
+  numeral: Pretendard Bold
+
+palette:
+  ground: "#FFFFFF"
+  surface: "#F1F4F8"
+  ink: "#1A2230"
+  ink-muted: "#4A5568"
+  line: "#C8D0DA"
+  accent: "#A61B1B"
+  accent-deep: "#233A4F"
+  accent-tint: "#E8EEF4"
+  field: "#233A4F"
+  on-field: "#FFFFFF"
+  positive: "#1E7A3F"
+  negative: "#1A2230"
+  series: ["#A61B1B", "#233A4F", "#4A5568", "#7A6A2A"]
+
+ramp: reading
+hero: false
+type-voice:
+  title-tracking: -1
+  display-tracking: -1
+  latin-case: sentence
+  figures: tabular
+
+density: 10
+variance: 4
+radius: 0
+edge: fill+border
+
+treatments: [band, top-rule, kicker-numeral, side-rail]
+role-defaults:
+  content: band
+  data: top-rule
+  data-takeaway: side-rail
+  sequence: kicker-numeral
+  image: side-rail
+  statement: band
+  reference: top-rule
+  definition: side-rail
+
+decoration: [header-band, box-outline, hairline-rule, numeral]
+layout-families: [summary-box-list, text-two-column, text-column, ledger-table, table-insight, comparison, timeline, matrix-2x2, agenda, references-appendix]
+# Display slides: how a type-led cover, a statement, a big number and a closing's next step are
+# drawn under this pack (references/layout-families.md, "Display slides").
+display:
+  cover: band
+  number: outline
+  closing: box
+  index: true
+covers: [cover-band, cover-typographic, cover-index]
+sections: [section-band, section-rule]
+closings: [closing-decision-box, closing-ask]
+
+table:
+  style: header-fill
+  header: field
+  header-ink: on-field
+  rules: grid
+  banding: surface
+  numbers: right-tabular
+  totals: bold
+chart:
+  gridlines: hairline
+  labels: direct
+  highlight: accent-on-muted
+  annotation: off
+image:
+  bleed: none
+  crop: none
+  frame: hairline
+
+fill-order: [step-up, distribute, change-family, anchor-visual]
+avoid:
+  - English section kickers
+  - red for anything but the key line
+  - a summary box longer than three lines
+  - more than three text families in a row

package/.grok/skills/lit-pptx/templates/tonalities/ledger/pack.yaml

@@ -0,0 +1,100 @@
+# Ledger: a quarterly review the reader studies line by line. Compact type, tabular figures,
+# tables and KPI rows carry the argument; the accent marks the current period and one key figure.
+# A poor fit for a short spoken pitch or for a briefing written as running prose.
+id: ledger
+name: Ledger
+version: "1.0.0"
+intent: "Dense, numbers-forward review decks that are read closely."
+canvas: ["16:9", "4:3"]
+
+# LitGrok bundles Pretendard Regular and Bold only: title range comes from size, colour and placement.
+faces:
+  display: Pretendard Bold
+  title: Pretendard Bold
+  body: Pretendard Regular
+  label: Pretendard Regular
+  numeral: Pretendard Bold
+faces-pretendard-only:
+  display: Pretendard Bold
+  title: Pretendard Bold
+  body: Pretendard Regular
+  label: Pretendard Regular
+  numeral: Pretendard Bold
+
+palette:
+  ground: "#FFFFFF"
+  surface: "#F2F4F6"
+  ink: "#16212C"
+  ink-muted: "#4B5866"
+  line: "#D0D6DC"
+  accent: "#0E6B5A"
+  accent-deep: "#0A4438"
+  accent-tint: "#E2F0EC"
+  field: "#0A4438"
+  on-field: "#FFFFFF"
+  positive: "#1E7A3F"
+  negative: "#B3261E"
+  series: ["#0E6B5A", "#4B5866", "#9A6A12", "#2F5F8A"]
+
+ramp: reading
+hero: false
+type-voice:
+  title-tracking: -1
+  display-tracking: -1
+  latin-case: sentence
+  figures: tabular
+
+density: 10
+variance: 5
+radius: 0
+edge: fill
+
+treatments: [top-rule, side-rail, kicker-numeral, bottom-anchor]
+role-defaults:
+  content: top-rule
+  data: top-rule
+  data-takeaway: side-rail
+  sequence: kicker-numeral
+  image: bottom-anchor
+  statement: side-rail
+  reference: top-rule
+  definition: side-rail
+
+decoration: [accent-rule, hairline-rule, rail-fill, numeral]
+layout-families: [kpi-row, kpi-over-chart, dashboard-grid, ledger-table, table-insight, chart-insight, full-chart, big-number, comparison, timeline, matrix-2x2, agenda, text-two-column, references-appendix]
+# Display slides: how a type-led cover, a statement, a big number and a closing's next step are
+# drawn under this pack (references/layout-families.md, "Display slides").
+display:
+  cover: figures
+  number: tint
+  closing: box
+  index: true
+covers: [cover-figures, cover-typographic, cover-index]
+sections: [section-rule, section-numeral]
+closings: [closing-decision-box, closing-ask]
+
+table:
+  style: ledger
+  # The header row is the ledger's one dark mass: deep field, white labels.
+  header: field
+  header-ink: on-field
+  rules: header-and-totals
+  banding: none
+  numbers: right-tabular
+  totals: bold
+chart:
+  gridlines: hairline
+  labels: direct
+  highlight: accent-on-muted
+  annotation: on
+image:
+  bleed: side-only
+  crop: none
+  frame: hairline
+
+fill-order: [step-up, distribute, anchor-visual, change-family]
+avoid:
+  - KPI cards for counts that are not results
+  - more than one accent on a chart
+  - tables stretched by padding
+  - side-rail on two data slides in a row

package/.grok/skills/lit-pptx/templates/tonalities/night/pack.yaml

@@ -0,0 +1,100 @@
+# Night: a screen in a dark hall. Near-black ground, off-white type, an amber accent with a soft
+# blue second series, light numerals and large charts. A poor fit for printed or read decks, and
+# never mixed with light slides in one deck.
+id: night
+name: Night
+version: "1.0.0"
+intent: "Data and technical keynotes on a dark ground."
+canvas: ["16:9", "4:3"]
+
+# LitGrok bundles Pretendard Regular and Bold only: title range comes from size, colour and placement.
+faces:
+  display: Pretendard Bold
+  title: Pretendard Bold
+  body: Pretendard Regular
+  label: Pretendard Regular
+  numeral: Pretendard Regular
+faces-pretendard-only:
+  display: Pretendard Bold
+  title: Pretendard Bold
+  body: Pretendard Regular
+  label: Pretendard Regular
+  numeral: Pretendard Regular
+
+palette:
+  ground: "#0F1419"
+  surface: "#1A222B"
+  ink: "#E8EDF2"
+  ink-muted: "#A3AEBA"
+  line: "#5A6672"
+  accent: "#E3A857"
+  accent-deep: "#F2C98A"
+  accent-tint: "#2A2418"
+  field: "#1E2A36"
+  on-field: "#F5F7FA"
+  positive: "#6CC08B"
+  negative: "#F08A7E"
+  series: ["#E3A857", "#7FB8E0", "#A3AEBA", "#C58FD0"]
+
+ramp: reading
+hero: false
+type-voice:
+  title-tracking: -1
+  display-tracking: -2
+  latin-case: sentence
+  figures: tabular
+
+density: 10
+variance: 6
+radius: 6
+edge: fill
+
+treatments: [top-plain-large, statement, side-rail, kicker-numeral, band]
+role-defaults:
+  content: top-plain-large
+  data: band
+  data-takeaway: side-rail
+  sequence: kicker-numeral
+  image: top-plain-large
+  statement: statement
+  reference: band
+  definition: side-rail
+
+decoration: [header-band, hairline-rule, numeral, rail-fill]
+layout-families: [full-chart, chart-insight, kpi-row, kpi-over-chart, dashboard-grid, big-number, method, comparison, timeline, statement]
+# Display slides: how a type-led cover, a statement, a big number and a closing's next step are
+# drawn under this pack (references/layout-families.md, "Display slides").
+display:
+  cover: numeral
+  statement: open
+  number: tint
+  closing: band
+covers: [cover-numeral, cover-typographic, cover-figures]
+sections: [section-numeral, section-field]
+closings: [closing-statement, closing-decision-box]
+
+table:
+  style: header-fill
+  header: surface
+  header-ink: ink
+  rules: rows
+  banding: none
+  numbers: right-tabular
+  totals: bold
+  protagonist: accent-tint
+chart:
+  gridlines: hairline
+  labels: direct
+  highlight: accent-on-muted
+  annotation: on
+image:
+  bleed: side-only
+  crop: allowed
+  frame: none
+
+fill-order: [anchor-visual, step-up, distribute, change-family]
+avoid:
+  - neon or saturated glows
+  - a pure black ground
+  - light slides mixed in
+  - thin light type below 18 pt