📦 deps(thirdparty): update snapshots

2026-07-18 00:02:59 +00:00
parent 82f7c6e56a
commit 47ce7f78dc
1446 changed files with 141041 additions and 6442 deletions
@@ -0,0 +1,91 @@
+# PPTX Reference Deck Analysis Recipes
+
+This file is static guidance for inspecting existing `.pptx` files and defining expected analysis outputs.
+
+## Scope
+
+- Keep only static guidance for reference-deck prompt context, extraction, folder analysis, and style-master inspection.
+- Do not place runtime scripts, model assets, importable Python modules, or generated artifacts here.
+- This skill ships no importable code; implement the extraction/style-analysis contract on demand with `python-pptx`.
+- `python-snippets.md` holds documentation-only `python-pptx` guidance — approach notes plus short illustrative snippets. Do not import from it or recreate packaged `.py` resources from it.
+
+## Analysis Recipes
+
+### 1. Prompt Context Recipe
+
+Build compact LLM-ready context from a reference deck.
+
+Expected result:
+
+- `slide_count`, `slide_size`
+- `styles`, `brands`, `template`, `layout`
+- Per-slide title/text snippets and shape counts
+
+### 2. Full Extraction Recipe
+
+Produce a full JSON extraction including:
+
+- `summary` complexity metrics
+- `slides[*].layout_tree` with groups/objects
+- `ooxml_elements` for render-aware inspection
+
+### 3. Folder Batch Recipe
+
+Process a folder of decks to produce:
+
+- One `.pptx-spec.json` file per deck
+- A `manifest.json` to track outputs
+
+### 4. Style Master Recipe
+
+Run style-only analysis when you need design lock signals:
+
+- Palette and accent colors
+- Typography and font-size distribution
+- Master/layout usage and flow patterns
+
+### 5. Reference Template Catalog Recipe
+
+When a reference deck should inform a new deck's layout rhythm, produce a
+human-readable catalog from the existing prompt-context, extraction, and
+style-master outputs. This is a view over the same analysis, not a separate
+extraction workflow.
+
+- List every source slide by **zero-based** index.
+- Record `layout_role`, a short visual description, usable regions,
+	placeholder roles, visual structures, and content-fit constraints.
+- Use the catalog to select layout inspiration for the new outline. Re-author
+	every target slide with an independent coordinate-explicit `layout_tree`.
+- Do not clone, rearrange, replace text in, or otherwise mutate the source deck.
+- Do not inherit source content, fonts, images, or proprietary assets without
+	explicit permission and licensing evidence.
+
+Suggested catalog shape:
+
+```json
+{
+	"source_deck": "reference.pptx",
+	"slide_count": 12,
+	"slides": [
+		{
+			"source_index": 0,
+			"layout_role": "cover",
+			"description": "Dark cover with title and subtitle regions",
+			"regions": ["title", "subtitle", "supporting visual"],
+			"placeholder_roles": ["ctrTitle", "subTitle"],
+			"visual_structures": ["full-bleed color field", "corner motif"],
+			"reuse_constraints": ["best for one title and one short subtitle"]
+		}
+	]
+}
+```
+
+## Related Responsibilities
+
+This reference covers PPTX prompt context, extraction, folder batch analysis,
+style-master inspection, and the derived reference-template catalog only.
+
+- Use the parent `pptx-deck-creation` workflow for narrative/source preparation,
+  together with [design profiles](design-profiles.md) for profile selection.
+- Use [visual asset guidelines](visual-asset-adapters.md) for acquiring and
+  placing icons, images, SVGs, and infographics.