Skip to content

AI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations, data-backed charts and tables on demand, audio narration from speaker notes, and support for your own .pptx templates. · by Hugo He

feat(vocabularies): add complete chart and preset maps

hugohe3b1112ac564f3
diff --git a/skills/ppt-master/references/preset-shape-vocabulary.md b/skills/ppt-master/references/preset-shape-vocabulary.md
new file mode 100644
index 00000000..43d69d71
--- /dev/null
+++ b/skills/ppt-master/references/preset-shape-vocabulary.md
@@ -0,0 +1,133 @@
+# Native Preset Shape Vocabulary
+
+This is Executor's complete authoring-side map of the 187 registered DrawingML
+preset names. Read it once before choosing a newly authored page or template
+contour. The Office categories and family descriptions expose what exists and
+what each contour objectively depicts; the current page's meaning, visual
+system, and composition determine whether and how to use it.
+
+**Reference — not a constraint**: the order and families are browse aids, not
+rankings, recommendations, whitelists, quotas, or automatic selections. A
+primitive, compound construction, necessary freeform, or no drawn carrier may
+still be the best result.
+
+**Hard rule — registered identities and behavior boundaries**:
+
+- `flowChart*` names carry conventional flowchart meanings; they are not generic decorative nodes.
+- `actionButton*` names provide visual button geometry only; they create no action, hyperlink, or navigation target.
+- `bentConnector*` and `curvedConnector*` are connector contours, but newly authored instances have no endpoint attachment.
+- `chartX`, `chartStar`, and `chartPlus` are partition symbols, not data charts.
+- Literal pictograms and mathematical operators retain the identity named here.
+
+**When to run**: run `preset_shape_svg.py describe <name> --compact` only when
+an exact candidate needs objective adjustment, connector, path,
+connection-site, or text rectangle facts. Authoring syntax and fragment
+contracts remain in
+[`native-shape-authoring.md`](./native-shape-authoring.md).
+
+## 1. Lines
+
+Straight, bent, and curved relationship contours.
+
+| Family | Objective identity | Exact preset names |
+|---|---|---|
+| Straight lines and connectors | Two diagonal orientations plus one straight connector contour. | `line`, `lineInv`, `straightConnector1` |
+| Bent connectors | Orthogonal connector contours with one through four bends. | `bentConnector2`, `bentConnector3`, `bentConnector4`, `bentConnector5` |
+| Curved connectors | Curved connector contours with increasing segment complexity. | `curvedConnector2`, `curvedConnector3`, `curvedConnector4`, `curvedConnector5` |
+
+## 2. Rectangles
+
+Neutral and corner-inflected rectangular carriers.
+
+| Family | Objective identity | Exact preset names |
+|---|---|---|
+| Neutral rectangular carriers | Square-corner and uniformly rounded rectangular contours. | `rect`, `roundRect` |
+| Corner-inflected rectangles | Rectangles with one-sided, paired, diagonal, rounded, clipped, or mixed corner treatments. | `round1Rect`, `round2SameRect`, `round2DiagRect`, `snipRoundRect`, `snip1Rect`, `snip2SameRect`, `snip2DiagRect` |
+
+## 3. Basic Shapes
+
+Geometric bodies, boundaries, radial contours, and literal symbols.
+
+| Family | Objective identity | Exact preset names |
+|---|---|---|
+| Triangular bodies | Symmetric and right-triangle contours. | `triangle`, `rtTriangle` |
+| Slanted quadrilaterals | Diamond, parallelogram, symmetric trapezoid, and asymmetric trapezoid contours. | `diamond`, `parallelogram`, `trapezoid`, `nonIsoscelesTrapezoid` |
+| Regular polygon bodies | Five-, six-, seven-, eight-, ten-, and twelve-sided polygon contours. | `pentagon`, `hexagon`, `heptagon`, `octagon`, `decagon`, `dodecagon` |
+| Organic carriers | Oval and teardrop contours. | `ellipse`, `teardrop` |
+| Ornamental carriers | Concave-corner plaque and beveled rectangle contours. | `plaque`, `bevel` |
+| Radial contours and segments | Wedge, partial circle, thick arc, ring, chord, and open arc contours. | `pieWedge`, `pie`, `blockArc`, `donut`, `chord`, `arc` |
+| Frames, corners, and edge pieces | Folded corner, closed/open frames, L-corner, and diagonal stripe contours. | `foldedCorner`, `frame`, `halfFrame`, `corner`, `diagStripe` |
+| Brackets | Left, right, and paired square-bracket contours. | `leftBracket`, `rightBracket`, `bracketPair` |
+| Braces | Left, right, and paired curly-brace contours. | `leftBrace`, `rightBrace`, `bracePair` |
+| Literal pictograms | Named object, weather, emotion, prohibition, and cloud symbols. | `cube`, `can`, `lightningBolt`, `heart`, `sun`, `moon`, `smileyFace`, `noSmoking`, `cloud` |
+| Functional pictograms | Six- and nine-tooth gears plus a funnel symbol. | `gear6`, `gear9`, `funnel` |
+| Plus symbol | Broad plus/cross body. | `plus` |
+| Corner and edge tabs | Four corner or edge tabs that imply a rectangular field. | `cornerTabs`, `squareTabs`, `plaqueTabs` |
+| Partition symbols | Rectangles divided into four or six internal regions. | `chartX`, `chartStar`, `chartPlus` |
+
+## 4. Block Arrows
+
+Filled directional bodies for movement, sequence, return, exchange, and route
+emphasis.
+
+| Family | Objective identity | Exact preset names |
+|---|---|---|
+| Arrow-shaped carriers | A pointed pentagonal stage body and a V-notched directional stage. | `homePlate`, `chevron` |
+| Cardinal block arrows | Filled arrows pointing right, left, up, or down. | `rightArrow`, `leftArrow`, `upArrow`, `downArrow` |
+| Stylized forward arrows | Rightward arrows with tail stripes or an inward tail notch. | `stripedRightArrow`, `notchedRightArrow` |
+| Multi-axis arrows | Two-, three-, and four-direction arrow bodies. | `leftRightArrow`, `upDownArrow`, `leftUpArrow`, `leftRightUpArrow`, `quadArrow` |
+| Bent and return arrows | Sharp or rounded turns plus an explicit U-turn contour. | `bentUpArrow`, `bentArrow`, `uturnArrow` |
+| Circular arrows | One-way, counter-oriented, and two-way circular arrow contours. | `circularArrow`, `leftCircularArrow`, `leftRightCircularArrow` |
+| Curved and swoosh arrows | Curved arrows ending on each cardinal side plus a tapered swoosh. | `curvedRightArrow`, `curvedLeftArrow`, `curvedUpArrow`, `curvedDownArrow`, `swooshArrow` |
+| Arrow callout bodies | Text-bearing directional callouts in one-, two-, or four-way variants. | `leftArrowCallout`, `rightArrowCallout`, `upArrowCallout`, `downArrowCallout`, `leftRightArrowCallout`, `upDownArrowCallout`, `quadArrowCallout` |
+
+## 5. Equation Shapes
+
+Literal mathematical operators.
+
+| Family | Objective identity | Exact preset names |
+|---|---|---|
+| Equation operators | Addition, subtraction, multiplication, division, equality, and inequality symbols. | `mathPlus`, `mathMinus`, `mathMultiply`, `mathDivide`, `mathEqual`, `mathNotEqual` |
+
+## 6. Flowchart
+
+Conventional flowchart notation for explicit process diagrams.
+
+| Family | Objective identity | Exact preset names |
+|---|---|---|
+| Flowchart operations | Process, subprocess, alternate process, preparation, manual operation, and delay symbols. | `flowChartProcess`, `flowChartPredefinedProcess`, `flowChartAlternateProcess`, `flowChartPreparation`, `flowChartManualOperation`, `flowChartDelay` |
+| Flowchart decisions and routing | Decision, continuation, junction, collation, sorting, extraction, and merge symbols. | `flowChartDecision`, `flowChartConnector`, `flowChartOffpageConnector`, `flowChartSummingJunction`, `flowChartOr`, `flowChartCollate`, `flowChartSort`, `flowChartExtract`, `flowChartMerge` |
+| Flowchart input and output | General, manual, historical punched-media, and display input/output symbols. | `flowChartInputOutput`, `flowChartManualInput`, `flowChartPunchedCard`, `flowChartPunchedTape`, `flowChartDisplay` |
+| Flowchart documents | Single-document and multidocument symbols. | `flowChartDocument`, `flowChartMultidocument` |
+| Flowchart storage | Internal, offline, online, tape, disk, and drum storage symbols. | `flowChartInternalStorage`, `flowChartOfflineStorage`, `flowChartOnlineStorage`, `flowChartMagneticTape`, `flowChartMagneticDisk`, `flowChartMagneticDrum` |
+| Flowchart terminator | Start/end terminal symbol. | `flowChartTerminator` |
+
+## 7. Stars and Banners
+
+Emblems, bursts, banners, scrolls, and wave contours.
+
+| Family | Objective identity | Exact preset names |
+|---|---|---|
+| Stars | Four- through thirty-two-point star and burst contours. | `star4`, `star5`, `star6`, `star7`, `star8`, `star10`, `star12`, `star16`, `star24`, `star32` |
+| Irregular seals and explosions | Two irregular burst contours with different edge density. | `irregularSeal1`, `irregularSeal2` |
+| Straight ribbons | Raised, lowered, and outward-tailed straight banner contours. | `ribbon`, `ribbon2`, `leftRightRibbon` |
+| Curved ribbons | Upward- and downward-arcing ribbon contours. | `ellipseRibbon`, `ellipseRibbon2` |
+| Scrolls | Vertical and horizontal rolled-document contours. | `verticalScroll`, `horizontalScroll` |
+| Waves | Single and double undulating bands. | `wave`, `doubleWave` |
+
+## 8. Callouts
+
+Annotation bodies and leaders that point to another object or region.
+
+| Family | Objective identity | Exact preset names |
+|---|---|---|
+| Leader-line callouts | Unbordered, accent-bar, bordered, and accent-bordered bodies with straight, one-bend, or two-bend leaders. | `callout1`, `callout2`, `callout3`, `accentCallout1`, `accentCallout2`, `accentCallout3`, `borderCallout1`, `borderCallout2`, `borderCallout3`, `accentBorderCallout1`, `accentBorderCallout2`, `accentBorderCallout3` |
+| Wedge and thought callouts | Rectangular, rounded, oval, and cloud annotation bodies with wedge or thought tails. | `wedgeRectCallout`, `wedgeRoundRectCallout`, `wedgeEllipseCallout`, `cloudCallout` |
+
+## 9. Action Buttons
+
+Visual navigation-control shapes whose behavior must be assigned separately.
+
+| Family | Objective identity | Exact preset names |
+|---|---|---|
+| Action-button controls | Blank, home, help, information, directional, boundary, return, document, sound, and movie button faces. | `actionButtonBlank`, `actionButtonHome`, `actionButtonHelp`, `actionButtonInformation`, `actionButtonForwardNext`, `actionButtonBackPrevious`, `actionButtonEnd`, `actionButtonBeginning`, `actionButtonReturn`, `actionButtonDocument`, `actionButtonSound`, `actionButtonMovie` |
diff --git a/skills/ppt-master/scripts/docs/prompt_audit.md b/skills/ppt-master/scripts/docs/prompt_audit.md
index 66ba9125..0ac384b2 100644
--- a/skills/ppt-master/scripts/docs/prompt_audit.md
+++ b/skills/ppt-master/scripts/docs/prompt_audit.md
@@ -24,7 +24,7 @@ Exit code `1` on any deterministic error. An unaccepted exact duplicate or schem
| Corpus and hot-file token ceilings | error on budget overflow |
| Declared load sets (route/stage scenarios) | error on budget overflow, unknown files, selector/registry drift |
| Load coverage | error when a corpus file is in no load set and has no `coverage.exempt` entry |
-| Registry claims (layout patterns, modes, styles, renderings, types, charts) | error on ID/count/index drift |
+| Registry claims and declared vocabulary projections | error on ID/count/index/projection drift |
| Markdown references and declared authority edges | error on broken links or unreferenced edges |
| Cross-file exact duplicates | warning until adjudicated via `duplicates.accepted` |
| Cross-file near duplicates | informational candidates in the report; no finding |
@@ -38,6 +38,7 @@ The manifest is audit-only (`audit_only: true`, `runtime_consumed: false`); it i
- **New corpus file** → when no existing category exemption matches it, the audit fails with `LOAD_COVERAGE_GAP` until you add it to the load sets that read it or exempt it with a one-line reason. Exempt only material that never enters role context (for example, a legacy tombstone, generated maintenance asset, maintainer-only doc, or license notice); represent conditional runtime reads as incremental load sets.
- **Intentional exact duplicate** → run `--json`, copy the candidate's `kind`, `fingerprint`, and `paths` into `duplicates.accepted` with a reason. The acceptance identity is all three values, so separate path pairs with identical prose remain independently reviewable. Editing either reported raw block changes its fingerprint; stale acceptance fails with `DUPLICATE_ACCEPTED_STALE`.
- **Near duplicate** → inspect `duplicates.near` as heuristic maintenance information. It produces no warning. A maintainer may still record a stable intentional pair in `duplicates.accepted`; `--skip-near-duplicates` deliberately leaves accepted near pairs unchecked because that scan did not run.
+- **Registry projection** → declare `projection.source` plus an `entry_pattern` with a named `id` group on the canonical registry entry. The audit requires the projected ids to match the registry exactly and rejects duplicates, missing ids, and extra ids.
- **Schema owner** → every configured field must have a field-local definition signal in its declared owner. Split fields into separate owner entries when they belong to different artifacts. Generic `key` / `value` prose elsewhere on a long line is not a grammar signal; explicit assignments, field-local grammar/format language, and forms such as `field ... one of ...` are.
- **Intentional schema projection** → run `--json`, then copy the field's `owner_fingerprint` and each reviewed projection's `path` / `fingerprint` into that `schema_grammars[]` entry. Classify every projection as `producer`, `consumer`, `reference`, or `compatibility`, and record a one-line reason:
diff --git a/skills/ppt-master/scripts/prompt_audit.py b/skills/ppt-master/scripts/prompt_audit.py
index 94b53786..a6fcb394 100644
--- a/skills/ppt-master/scripts/prompt_audit.py
+++ b/skills/ppt-master/scripts/prompt_audit.py
@@ -1173,9 +1173,63 @@ def _registry_ids(
return set(range(len(value))), source, [], None
raise AuditError(f"Registry key {key} in {source} is not a collection")
+ if kind == "line_collection":
+ values = [
+ line.strip()
+ for line in _read_utf8(root / source).splitlines()
+ if line.strip()
+ ]
+ duplicates = sorted(
+ item for item, count in Counter(values).items() if count > 1
+ )
+ return set(values), source, duplicates, values
+
raise AuditError(f"Unsupported registry kind: {kind}")
+def _registry_projection_ids(
+ root: Path,
+ registry_name: str,
+ config: dict[str, Any],
+) -> tuple[set[str], str, list[str]] | None:
+ """Extract one declared Markdown projection of canonical registry ids."""
+ projection = config.get("projection")
+ if projection is None:
+ return None
+ if not isinstance(projection, dict):
+ raise AuditError(
+ f"Registry {registry_name} projection must be an object"
+ )
+ source = projection.get("source")
+ if not isinstance(source, str) or not (root / source).is_file():
+ raise AuditError(
+ f"Registry {registry_name} projection has missing source: {source}"
+ )
+ pattern = projection.get("entry_pattern")
+ if not isinstance(pattern, str):
+ raise AuditError(
+ f"Registry {registry_name} projection needs entry_pattern"
+ )
+ try:
+ regex = re.compile(pattern, re.MULTILINE)
+ except re.error as exc:
+ raise AuditError(
+ f"Invalid registry projection entry_pattern: {exc}"
+ ) from exc
+ if "id" not in regex.groupindex:
+ raise AuditError(
+ f"Registry {registry_name} projection entry_pattern needs an id group"
+ )
+ matched_ids = [
+ match.group("id")
+ for match in regex.finditer(_read_utf8(root / source))
+ ]
+ duplicates = sorted(
+ item for item, count in Counter(matched_ids).items() if count > 1
+ )
+ return set(matched_ids), source, duplicates
+
+
def _registry_count_claims(paragraph: Paragraph, nouns: list[str]) -> list[int]:
noun_pattern = "|".join(re.escape(noun) for noun in nouns)
patterns = (
@@ -1218,6 +1272,38 @@ def audit_registries(
path=source,
)
)
+ projection = _registry_projection_ids(root, name, config)
+ projection_source: str | None = None
+ projection_ids: set[str] | None = None
+ projection_duplicates: list[str] = []
+ if projection is not None:
+ projection_ids, projection_source, projection_duplicates = projection
+ for duplicate_id in projection_duplicates:
+ findings.append(
+ Finding(
+ severity="error",
+ code="REGISTRY_PROJECTION_ID_DUPLICATE",
+ message=(
+ f"{name} projection repeats id {duplicate_id!r}"
+ ),
+ path=projection_source,
+ )
+ )
+ canonical_ids = {str(item) for item in ids}
+ missing_ids = sorted(canonical_ids - projection_ids)
+ extra_ids = sorted(projection_ids - canonical_ids)
+ if missing_ids or extra_ids:
+ findings.append(
+ Finding(
+ severity="error",
+ code="REGISTRY_PROJECTION_MISMATCH",
+ message=(
+ f"{name} projection differs from its registry; "
+ f"missing={missing_ids}, extra={extra_ids}"
+ ),
+ path=projection_source,
+ )
+ )
expected_order: list[str] | None = None
expected_ids: set[str] | None = None
if config.get("kind") == "structured_markdown":
@@ -1446,6 +1532,15 @@ def audit_registries(
"expected_entries": len(expected_ids) if expected_ids is not None else None,
"index_labels": index_labels,
"index_targets": index_targets,
+ "projection": (
+ {
+ "source": projection_source,
+ "entries": len(projection_ids),
+ "duplicate_ids": projection_duplicates,
+ }
+ if projection_ids is not None
+ else None
+ ),
"claims": sorted(claims, key=lambda item: (item["path"], item["line"])),
}
)
diff --git a/skills/ppt-master/scripts/prompt_audit_manifest.json b/skills/ppt-master/scripts/prompt_audit_manifest.json
index ce6978d2..ceab9604 100644
--- a/skills/ppt-master/scripts/prompt_audit_manifest.json
+++ b/skills/ppt-master/scripts/prompt_audit_manifest.json
@@ -32,11 +32,13 @@
"skills/ppt-master/references/svg-effects.md": 15000,
"skills/ppt-master/references/native-data-interface.md": 6750,
"skills/ppt-master/references/pptx-structure-interface.md": 4750,
+ "skills/ppt-master/references/preset-shape-vocabulary.md": 2750,
"skills/ppt-master/references/strategist.md": 18000,
"skills/ppt-master/references/strategist-image.md": 3250,
"skills/ppt-master/references/strategist-template.md": 3000,
"skills/ppt-master/templates/design_spec_reference.md": 3750,
"skills/ppt-master/templates/spec_lock_reference.md": 2750,
+ "skills/ppt-master/templates/charts/chart-vocabulary.md": 1250,
"skills/ppt-master/workflows/generate-pptx.md": 18000,
"skills/ppt-master/workflows/stages/apply-template-workspace.md": 3500
},
@@ -154,7 +156,7 @@
"max_tokens": 14000
},
"route.generate.planning": {
- "description": "Generate-PPTX planning through Strategist, including the fixed capability-decision batch, complete compact Chart/Table registries, and a conservative audit envelope for only the exact custom bases selected afterward; schemas and optional scaffolds are tool-consumed. Ceiling raised after BUDGET_LOAD_SET reported 116384 tokens.",
+ "description": "Generate-PPTX planning through Strategist, including the fixed capability-decision batch, complete Chart expression vocabulary and Table registry, and a conservative audit envelope for only the exact custom bases selected afterward; schemas and optional scaffolds are tool-consumed. Ceiling raised after BUDGET_LOAD_SET reported 116384 tokens.",
"scope": "cumulative",
"include": [
"bootstrap.routing"
@@ -174,7 +176,7 @@
"skills/ppt-master/references/image-renderings/_index.md",
"skills/ppt-master/scripts/docs/confirm_ui.md",
"skills/ppt-master/templates/icons/README.md",
- "skills/ppt-master/templates/charts/charts_index.json",
+ "skills/ppt-master/templates/charts/chart-vocabulary.md",
"skills/ppt-master/templates/tables/tables_index.json",
{
"glob": "skills/ppt-master/references/modes/*.md",
@@ -218,6 +220,7 @@
"skills/ppt-master/references/shared-standards-core.md",
"skills/ppt-master/references/svg-effects.md",
"skills/ppt-master/references/native-shape-authoring.md",
+ "skills/ppt-master/references/preset-shape-vocabulary.md",
"skills/ppt-master/references/semantic-svg.md",
"skills/ppt-master/references/executor-structure.md",
"skills/ppt-master/references/canvas-formats.md",
@@ -227,7 +230,7 @@
"skills/ppt-master/references/visual-styles/_index.md",
"skills/ppt-master/references/image-renderings/_index.md",
"skills/ppt-master/templates/icons/README.md",
- "skills/ppt-master/templates/charts/charts_index.json",
+ "skills/ppt-master/templates/charts/chart-vocabulary.md",
"skills/ppt-master/templates/tables/tables_index.json",
{
"glob": "skills/ppt-master/references/modes/*.md",
@@ -444,7 +447,7 @@
"max_tokens": 7500
},
"stage.generate.template.style": {
- "description": "Conditional roster-free Style workspace application.",
+ "description": "Conditional roster-free Style workspace application. Ceiling raised after BUDGET_LOAD_SET reported 9019 tokens.",
"scope": "incremental",
"include": [
"stage.generate.apply-template-workspace"
@@ -457,7 +460,7 @@
"load_event": "template-application"
}
],
- "max_tokens": 9000
+ "max_tokens": 10000
},
"stage.generate.template.layout": {
"description": "Conditional Layout workspace application with one selected Layout spec.",
@@ -727,6 +730,7 @@
"skills/ppt-master/references/shared-standards-core.md",
"skills/ppt-master/references/svg-effects.md",
"skills/ppt-master/references/native-shape-authoring.md",
+ "skills/ppt-master/references/preset-shape-vocabulary.md",
"skills/ppt-master/references/semantic-svg.md",
"skills/ppt-master/references/executor-structure.md",
{
@@ -976,12 +980,13 @@
"max_tokens": 1000
},
"stage.create-template.authored-preset": {
- "description": "Conditional native preset and Boolean shape authoring reference for Create Layout/Create Deck. Ceiling raised after BUDGET_LOAD_SET reported 6618 tokens.",
+ "description": "Conditional complete preset vocabulary plus native preset and Boolean shape authoring authority for Create Layout/Create Deck. Ceiling raised after BUDGET_LOAD_SET reported 9139 tokens.",
"scope": "incremental",
"files": [
- "skills/ppt-master/references/native-shape-authoring.md"
+ "skills/ppt-master/references/native-shape-authoring.md",
+ "skills/ppt-master/references/preset-shape-vocabulary.md"
],
- "max_tokens": 7500
+ "max_tokens": 10000
},
"route.generate.planning-template": {
"description": "Generate-PPTX planning context after an explicit template workspace is installed. Ceiling raised after BUDGET_LOAD_SET reported 119170 tokens.",
@@ -1090,12 +1095,13 @@
"max_tokens": 1000
},
"stage.generate.executor.native-shape": {
- "description": "Stock PowerPoint shape selection and Boolean materialization authority, always included in Generate Executor contexts. Ceiling raised after BUDGET_LOAD_SET reported 6618 tokens.",
+ "description": "Complete stock PowerPoint shape vocabulary, selection, and Boolean materialization authority, always included in Generate Executor contexts. Ceiling raised after BUDGET_LOAD_SET reported 9139 tokens.",
"scope": "incremental",
"files": [
- "skills/ppt-master/references/native-shape-authoring.md"
+ "skills/ppt-master/references/native-shape-authoring.md",
+ "skills/ppt-master/references/preset-shape-vocabulary.md"
],
- "max_tokens": 7500
+ "max_tokens": 10000
},
"stage.shared.svg-effects": {
"description": "Advanced SVG paint, effects, transforms, and geometry authority, always included in Generate Executor contexts and conditionally loaded by other SVG-authoring routes.",
@@ -1617,6 +1623,10 @@
"kind": "json_collection",
"source": "skills/ppt-master/templates/charts/charts_index.json",
"key": "charts",
+ "projection": {
+ "source": "skills/ppt-master/templates/charts/chart-vocabulary.md",
+ "entry_pattern": "^\\|\\s*`chart/(?P<id>[a-z0-9_]+)`\\s*\\|"
+ },
"reference_terms": [
"charts_index.json",
"chart catalog",
@@ -1633,6 +1643,28 @@
"types"
]
},
+ {
+ "name": "preset-shape-vocabulary",
+ "kind": "line_collection",
+ "source": "skills/ppt-master/scripts/pptx_shapes/data/shape_type_values.txt",
+ "projection": {
+ "source": "skills/ppt-master/references/preset-shape-vocabulary.md",
+ "entry_pattern": "(?:\\|\\s|,\\s)`(?P<id>[A-Za-z][A-Za-z0-9]*)`(?=[^\\n]*\\|\\s*$)"
+ },
+ "reference_terms": [
+ "preset-shape-vocabulary.md",
+ "preset shape vocabulary",
+ "native preset shape vocabulary"
+ ],
+ "claim_nouns": [
+ "preset",
+ "presets",
+ "shape",
+ "shapes",
+ "name",
+ "names"
+ ]
+ },
{
"name": "table-templates",
"kind": "json_collection",
@@ -2069,6 +2101,10 @@
"glob": "skills/ppt-master/scripts/docs/image.md",
"reason": "Standalone image-tool command reference; generation roles load the owning image contracts directly, and its formula renderer section is legacy-only."
},
+ {
+ "glob": "skills/ppt-master/templates/charts/charts_index.json",
+ "reason": "Machine registry consumed by visualization validation and optional recall; planning roles load chart-vocabulary.md instead."
+ },
{
"glob": "skills/ppt-master/scripts/docs/mask-gradient-smoke.md",
"reason": "Maintainer-only executable smoke; never loaded by generation roles."
diff --git a/skills/ppt-master/templates/charts/chart-vocabulary.md b/skills/ppt-master/templates/charts/chart-vocabulary.md
new file mode 100644
index 00000000..f7a8a4aa
--- /dev/null
+++ b/skills/ppt-master/templates/charts/chart-vocabulary.md
@@ -0,0 +1,75 @@
+# Chart Expression Vocabulary
+
+This is the complete planning-side map of the 33 canonical Chart references.
+Choose from the page's actual information relationship, then retain the exact
+`chart/<key>` identifier. This file deliberately contains no SVG construction,
+data-binding, coordinate, label-placement, styling, or export instructions;
+those decisions belong to Executor after selection.
+
+**Reference — not a constraint**: each description states what the visual
+encoding represents. It is not a ranking, recommendation, threshold, quota, or
+substitute for judgment from the current data and communication goal. Zero
+Chart selections remains valid.
+
+## 1. Change over time
+
+| Canonical reference | Encoded relationship |
+|---|---|
+| `chart/line_chart` | Values positioned along a continuous axis, with connected marks showing change or direction. |
+| `chart/area_chart` | A continuous series whose filled area emphasizes magnitude across the axis. |
+| `chart/stacked_area_chart` | Multiple filled series whose layers encode both total magnitude and changing composition. |
+| `chart/dual_axis_line_chart` | Two continuous series measured on separate value scales. |
+| `chart/stock_chart` | Open, high, low, and close values across ordered dates. |
+| `chart/waterfall_chart` | Sequential positive and negative contributions connecting a starting value to an ending value. |
+
+## 2. Category comparison and rank
+
+| Canonical reference | Encoded relationship |
+|---|---|
+| `chart/column_chart` | Category values encoded by vertical length from a shared baseline. |
+| `chart/horizontal_bar_chart` | Category values encoded by horizontal length from a shared baseline. |
+| `chart/grouped_bar_chart` | Multiple series placed side by side within shared categories. |
+| `chart/stacked_bar_chart` | Category totals divided into value-driven component lengths. |
+| `chart/butterfly_chart` | Two datasets mirrored around one shared category axis. |
+| `chart/dumbbell_chart` | Two values per item joined to expose their gap and direction. |
+| `chart/pareto_chart` | Descending category contributions paired with their cumulative share. |
+
+## 3. Target and progress
+
+| Canonical reference | Encoded relationship |
+|---|---|
+| `chart/bullet_chart` | Actual values, targets, and optional performance bands on compact linear scales. |
+| `chart/progress_bar_chart` | Bounded completion values encoded as filled portions of linear tracks. |
+| `chart/gauge_chart` | One bounded value positioned against a circular or semicircular domain and reference marks. |
+
+## 4. Distribution and multivariable relationship
+
+| Canonical reference | Encoded relationship |
+|---|---|
+| `chart/histogram_chart` | Observation frequency encoded across contiguous numeric bins. |
+| `chart/box_plot_chart` | Median, quartiles, spread, and outliers summarized for one or more groups. |
+| `chart/scatter_chart` | Two numeric variables encoded by x/y position. |
+| `chart/bubble_chart` | Two variables encoded by x/y position and a third by mark size. |
+| `chart/heatmap_chart` | Values at row-column intersections encoded by color intensity. |
+| `chart/radar_chart` | Multiple measures positioned on radial axes for one or more entities. |
+| `chart/matrix_2x2` | Items positioned by two numeric dimensions, with optional magnitude encoded by radius. |
+
+## 5. Part-to-whole and hierarchy
+
+| Canonical reference | Encoded relationship |
+|---|---|
+| `chart/pie_chart` | Flat parts of one whole encoded by sector angle and area. |
+| `chart/donut_chart` | Flat parts of one whole encoded around an open center. |
+| `chart/pie_of_pie_chart` | One composition with selected parts expanded into a secondary pie. |
+| `chart/bar_of_pie_chart` | One composition with selected parts expanded into a secondary stacked bar. |
+| `chart/treemap_chart` | Hierarchical or grouped parts encoded as nested rectangular areas. |
+| `chart/sunburst_chart` | Hierarchical parts encoded as concentric radial levels and angular spans. |
+
+## 6. Flow, schedule, and weighted text
+
+| Canonical reference | Encoded relationship |
+|---|---|
+| `chart/funnel_chart` | Ordered stage values encoded as changing widths through a conversion sequence. |
+| `chart/sankey_chart` | Magnitude moving between nodes encoded by connection width. |
+| `chart/gantt_chart` | Tasks positioned and sized by dates or durations along a time axis. |
+| `chart/word_cloud` | Term weight or frequency encoded by type size. |