ooxml-core 0.2.0

package/dist/geometry/preset-geometry-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-geometry-names.d.ts","sourceRoot":"","sources":["../../src/geometry/preset-geometry-names.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EA4LjD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA4BpE,CAAC;AASF;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAE/D;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAUjF"}

package/dist/geometry/preset-shape-clip-paths.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Master lookup: lowercase OOXML preset name → CSS `clip-path` value.
+ * Returns `undefined` for shapes that need SVG rendering.
+ */
+export declare const PRESET_SHAPE_CLIP_PATHS: Record<string, string | undefined>;
+/**
+ * Lookup a clip-path for any OOXML preset geometry name.
+ * Returns `undefined` when the shape should be rendered as a
+ * full rectangle (no clipping) or when a more complex SVG
+ * rendering is needed.
+ */
+export declare function getPresetShapeClipPath(presetName: string | undefined): string | undefined;
+//# sourceMappingURL=preset-shape-clip-paths.d.ts.map

package/dist/geometry/preset-shape-clip-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-shape-clip-paths.d.ts","sourceRoot":"","sources":["../../src/geometry/preset-shape-clip-paths.ts"],"names":[],"mappings":"AAWA;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAGtE,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAKzF"}

package/dist/geometry/preset-shape-definitions-action-buttons.d.ts

@@ -0,0 +1,45 @@
+/**
+ * ECMA-376 ST_ShapeType preset geometry definitions — action buttons.
+ *
+ * The 12 `actionButton*` shapes (`actionButtonBlank`, `actionButtonHome`,
+ * `actionButtonHelp`, `actionButtonInformation`, `actionButtonForwardNext`,
+ * `actionButtonBackPrevious`, `actionButtonEnd`, `actionButtonBeginning`,
+ * `actionButtonReturn`, `actionButtonDocument`, `actionButtonSound`,
+ * `actionButtonMovie`) all share the same OOXML preset geometry: a beveled
+ * rectangle. The inner glyph (home / help / sound / etc.) is rendered
+ * separately by the React layer via `ActionButtonGlyphOverlay`, so we only
+ * need to express the button frame here.
+ *
+ * Geometry: outer rectangle covering the full bounds, plus an inner inset
+ * rectangle (the bevel "well"). The inset is `ss / 16` — i.e. one sixteenth
+ * of the shorter side, i.e. the fixed literal fraction `6250` in the
+ * canonical 100000-based OOXML scale. COM-verified 2026-09-05
+ * (`Shape.Adjustments.Count` reads 0 for every `actionButton*` AutoShape at
+ * any size): unlike `roundRect`/`octagon`/etc., this fraction is NOT an
+ * adjustable guide in real PowerPoint - the 12 `actionButton*` presets ship
+ * with an EMPTY `avLst`, so a saved file that carries an `<a:gd name="adj"
+ * .../>` for one of them is authoring a guide name PowerPoint's own preset
+ * geometry does not recognise (the same corruption class documented in
+ * `preset-adjustment-validation.ts`: an unrecognised guide name on a preset
+ * that HAS real guides makes PowerPoint refuse to open the file). Diagonal
+ * lines from each outer corner to the matching inner corner ensure a
+ * stroked outline reads as a true bevel.
+ *
+ * All twelve shapes use identical geometry: a single helper, `buildActionButton`,
+ * stamps each definition with the right `name` so the table stays a one-line
+ * declaration per shape.
+ *
+ * Aggregation into `PRESET_SHAPE_GEOMETRY_TABLE` is performed manually in
+ * `preset-shape-definitions-table.ts` after batch agents return.
+ */
+import type { PresetShapeGeometryDefinition } from './preset-shape-definitions-table.js';
+/**
+ * Action-button preset definitions exported for manual aggregation into
+ * `PRESET_SHAPE_GEOMETRY_TABLE`. Keys are ECMA-376 ST_ShapeType names.
+ *
+ * NOTE: this constant name (`ACTION_BUTTON_PRESET_DEFINITIONS`) intentionally
+ * differs from the React package's `ACTION_BUTTON_PRESETS` (editor-side icon
+ * paths) so the two never collide.
+ */
+export declare const ACTION_BUTTON_PRESET_DEFINITIONS: Record<string, PresetShapeGeometryDefinition>;
+//# sourceMappingURL=preset-shape-definitions-action-buttons.d.ts.map

package/dist/geometry/preset-shape-definitions-action-buttons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-shape-definitions-action-buttons.d.ts","sourceRoot":"","sources":["../../src/geometry/preset-shape-definitions-action-buttons.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,qCAAqC,CAAC;AA8EzF;;;;;;;GAOG;AACH,eAAO,MAAM,gCAAgC,EAAE,MAAM,CAAC,MAAM,EAAE,6BAA6B,CAa1F,CAAC"}

package/dist/geometry/preset-shape-definitions-arrow-callouts.d.ts

@@ -0,0 +1,55 @@
+/**
+ * ECMA-376 ST_ShapeType preset geometry definitions — arrow callouts +
+ * `leftUpArrow`.
+ *
+ * This batch authors the 10 arrow-callout family shapes whose geometry is
+ * defined in Microsoft's `presetShapeDefinitions.xml` (ISO/IEC 29500-1
+ * §20.1.10.55):
+ *
+ *   • `leftArrowCallout`, `rightArrowCallout`, `upArrowCallout`,
+ *     `downArrowCallout`
+ *   • `leftRightArrowCallout`, `upDownArrowCallout`, `quadArrowCallout`
+ *   • `bentArrowCallout`, `bentUpArrowCallout`
+ *   • `leftUpArrow` (L-shaped two-direction arrow combining left + up)
+ *
+ * Each callout shape is an arrow with a rectangular text "callout" body
+ * appended to its tail. Adjustments:
+ *   • adj1 = arrow-head body width as % of (h/2 or w/2 depending on orient.)
+ *   • adj2 = arrow-shaft thickness as % of (h/2 or w/2)
+ *   • adj3 = arrow-head length as % of (w or h)
+ *   • adj4 = callout body extent as % of (w or h)
+ *
+ * The data layout mirrors `preset-shape-definitions-table.ts`: tokens inside
+ * guide formulas and path commands are raw OOXML strings. See the evaluator
+ * `preset-shape-evaluator` / `guide-formula-eval` for operator semantics.
+ *
+ * # Spec faithfulness
+ *
+ * All shapes here use the canonical Microsoft default-adjustment guide
+ * formulas. Polygons honour arbitrary `adj*` overrides via the same
+ * formula set Microsoft ships, with the following simplifications flagged
+ * in-line:
+ *
+ *   • `quadArrowCallout` uses a symmetric polygon parameterised by adj1..adj5
+ *     (head-body, shaft, head-length, callout-extent and text-rect adj).
+ *     The full ECMA formula set chains 30+ guides — this batch authors a
+ *     reduced form whose visible silhouette is identical at the spec
+ *     defaults (avLst adj1..adj5 = 22500, 22500, 22500, 22500, 22500).
+ *   • `bentArrowCallout` / `bentUpArrowCallout` use the same simplified
+ *     polygon strategy as `bentArrow` / `bentUpArrow` in the sibling
+ *     `preset-shape-definitions-arrows.ts` batch.
+ *
+ * # Aggregation
+ *
+ * The aggregator that exports `PRESET_SHAPE_GEOMETRY_TABLE` lives in
+ * `preset-shape-definitions-table.ts`. Spread `ARROW_CALLOUT_PRESET_DEFINITIONS`
+ * into the master record after the human-driven merge of all batch agents.
+ */
+import type { PresetShapeGeometryDefinition } from './preset-shape-definitions-table.js';
+/**
+ * Arrow-callout family preset definitions. The aggregator in
+ * `preset-shape-definitions-table.ts` should spread this record into
+ * `PRESET_SHAPE_GEOMETRY_TABLE` after this batch is merged.
+ */
+export declare const ARROW_CALLOUT_PRESET_DEFINITIONS: Record<string, PresetShapeGeometryDefinition>;
+//# sourceMappingURL=preset-shape-definitions-arrow-callouts.d.ts.map

package/dist/geometry/preset-shape-definitions-arrow-callouts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-shape-definitions-arrow-callouts.d.ts","sourceRoot":"","sources":["../../src/geometry/preset-shape-definitions-arrow-callouts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAEH,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,qCAAqC,CAAC;AAkjBzF;;;;GAIG;AACH,eAAO,MAAM,gCAAgC,EAAE,MAAM,CAAC,MAAM,EAAE,6BAA6B,CAW1F,CAAC"}

package/dist/geometry/preset-shape-definitions-arrows-refined.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Refined ECMA-376 ST_ShapeType preset geometry definitions for the
+ * eight arrow shapes whose canonical formulas were previously reduced to
+ * default-adjustment silhouettes in `preset-shape-definitions-arrows.ts`.
+ *
+ * Each entry below drives its geometry from the `avLst` adjust values so the
+ * generated path honours arbitrary overrides instead of being baked at the
+ * spec defaults.
+ *
+ * `bentArrow`, `bentUpArrow`, and `uturnArrow` are verbatim transcriptions of
+ * the canonical `presetShapeDefinitions.xml` payload (ISO/IEC 29500-1
+ * §20.1.10.55). The remaining circular / swoosh variants reproduce the spec's
+ * guide chain closely but are adjustment-responsive approximations of the
+ * arrowhead-tangent maths, not byte-for-byte transcriptions.
+ *
+ * The aggregator in `preset-shape-definitions-table.ts` is expected to
+ * spread `REFINED_ARROW_PRESET_DEFINITIONS` *after*
+ * `ARROW_PRESET_DEFINITIONS` so these refined entries override the
+ * simplified versions while leaving the rest of the arrows batch
+ * untouched. Keeping the refinements in their own module avoids merge
+ * contention with the original arrows batch agent.
+ *
+ * Shapes refined here:
+ *   • bentArrow       (4 adjusts: head width, head length, body, knee)
+ *   • bentUpArrow     (3 adjusts)
+ *   • uturnArrow      (5 adjusts)
+ *   • circularArrow   (5 adjusts)
+ *   • leftCircularArrow      (5 adjusts; mirrors circularArrow)
+ *   • leftRightCircularArrow (5 adjusts; heads at both ends of arc)
+ *   • swooshArrow     (2 adjusts)
+ *
+ * (`curvedRightArrow` was promoted to a spec-exact transcription in
+ * `preset-shape-definitions-curved-arrows-exact.ts`.)
+ *
+ * Conventions (matching the rest of the geometry layer):
+ *   • EMU-aware tokens like `ss`, `wd2`, `hd2`, `cd2`, `cd4`, `cd8`
+ *     resolve to half-side / quarter-circle / eighth-circle constants
+ *     in the evaluator.
+ *   • All numeric arguments are stored as raw OOXML token strings;
+ *     `guide-formula-eval` resolves them against the runtime guide
+ *     context (no premature conversion to numbers).
+ */
+import type { PresetShapeGeometryDefinition } from './preset-shape-definitions-table.js';
+export declare const REFINED_ARROW_PRESET_DEFINITIONS: Record<string, PresetShapeGeometryDefinition>;
+//# sourceMappingURL=preset-shape-definitions-arrows-refined.d.ts.map

package/dist/geometry/preset-shape-definitions-arrows-refined.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-shape-definitions-arrows-refined.d.ts","sourceRoot":"","sources":["../../src/geometry/preset-shape-definitions-arrows-refined.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,qCAAqC,CAAC;AA8jBzF,eAAO,MAAM,gCAAgC,EAAE,MAAM,CAAC,MAAM,EAAE,6BAA6B,CAQ1F,CAAC"}

package/dist/geometry/preset-shape-definitions-arrows.d.ts

@@ -0,0 +1,52 @@
+/**
+ * ECMA-376 ST_ShapeType preset geometry definitions — arrows + 3D primitives.
+ *
+ * This batch authors ~25 additional shapes whose geometry is defined in
+ * Microsoft's `presetShapeDefinitions.xml` (ISO/IEC 29500-1 §20.1.10.55):
+ *
+ * Containers / 3-D primitives
+ *  • `bevel`, `can`, `cube`, `cylinder`
+ *  • `frame`, `halfFrame`, `plaque`, `plaqueTabs`
+ *
+ * Arrow variants
+ *  • Bidirectional: `leftRightArrow`, `upDownArrow`, `leftRightUpArrow`,
+ *    `quadArrow`
+ *  • Bent / U-turn: `bentArrow`, `bentUpArrow`, `uturnArrow`
+ *  • Decorated: `stripedRightArrow`, `notchedRightArrow`
+ *  • Block-direction: `homePlate`, `chevron`, `pentArrow` (5-sided arrow)
+ *  • Curved / circular: `circularArrow`, `leftCircularArrow`,
+ *    `leftRightCircularArrow`, `swooshArrow`, `curvedRightArrow`
+ *
+ * The data layout mirrors `preset-shape-definitions-table.ts`. Every entry is
+ * keyed by its ECMA-376 ST_ShapeType name (camelCase). Tokens inside guide
+ * formulas and path commands are raw OOXML strings — the `preset-shape-
+ * evaluator` pipes them through `guide-formula-eval` (operators `val`, `abs`,
+ * `sqrt`, `+-`, `*\/`, `+/`, `?:`, `min`, `max`, `mod`, `pin`, `sin`, `cos`,
+ * `tan`, `atan`, `at2`, `cat2`, `sat2`).
+ *
+ * # Spec-faithful where the formulas are tractable
+ *
+ * Most shapes here use the canonical Microsoft formula set. A handful of
+ * shapes whose XML pulls in 50+ guides (notably `swooshArrow`,
+ * `circularArrow`, `leftCircularArrow`, `leftRightCircularArrow`,
+ * `curvedRightArrow`, `bentArrow`, `bentUpArrow`, `uturnArrow`) are reduced
+ * to a faithful default-adjustment polygon / Bézier silhouette that is
+ * visually correct at the spec-default avLst values. They do not yet honour
+ * arbitrary adjustment overrides — those reductions are flagged as
+ * `SIMPLIFIED:` in the in-source comments so future work can replace them
+ * with the full formula set.
+ *
+ * # Adding to the master table
+ *
+ * The aggregator that exports `PRESET_SHAPE_GEOMETRY_TABLE` lives in
+ * `preset-shape-definitions-table.ts`. Spread `ARROW_PRESET_DEFINITIONS` into
+ * the master record after the human-driven merge of all batch agents.
+ */
+import type { PresetShapeGeometryDefinition } from './preset-shape-definitions-table.js';
+/**
+ * Arrow + 3-D primitive preset definitions. The aggregator in
+ * `preset-shape-definitions-table.ts` should spread this record into
+ * `PRESET_SHAPE_GEOMETRY_TABLE` after this batch is merged.
+ */
+export declare const ARROW_PRESET_DEFINITIONS: Record<string, PresetShapeGeometryDefinition>;
+//# sourceMappingURL=preset-shape-definitions-arrows.d.ts.map

package/dist/geometry/preset-shape-definitions-arrows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-shape-definitions-arrows.d.ts","sourceRoot":"","sources":["../../src/geometry/preset-shape-definitions-arrows.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,qCAAqC,CAAC;AAm+BzF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,6BAA6B,CA0BlF,CAAC"}

package/dist/geometry/preset-shape-definitions-chart-marks.d.ts

@@ -0,0 +1,23 @@
+/**
+ * ECMA-376 ST_ShapeType preset geometry definitions - chart marker glyphs.
+ *
+ * `chartX`, `chartStar` and `chartPlus` are the three data-marker presets
+ * PowerPoint and Excel use for scatter / line series markers. They are real
+ * `ST_ShapeType` members (ISO/IEC 29500-1 section 20.1.10.55) but were the
+ * last three preset names still missing from `PRESET_SHAPE_GEOMETRY_TABLE`,
+ * so they degraded to the static polygon approximations in
+ * `preset-shape-clip-paths.ts`.
+ *
+ * Each is transcribed verbatim from Microsoft's `presetShapeDefinitions.xml`:
+ * a `fill="none"` stroke path carrying the actual glyph strokes, followed by
+ * a `stroke="false"` square that supplies the fill/hit region. None of the
+ * three declares an `avLst`, a `gdLst` or a `rect`, so the geometry depends
+ * only on the 10x10 path coordinate space each sub-path declares.
+ *
+ * Aggregated into `PRESET_SHAPE_GEOMETRY_TABLE` by
+ * `preset-shape-definitions-table.ts`.
+ */
+import type { PresetShapeGeometryDefinition } from './preset-shape-definitions-table.js';
+/** Chart-marker preset definitions, keyed by ECMA-376 ST_ShapeType name. */
+export declare const CHART_MARK_PRESET_DEFINITIONS: Record<string, PresetShapeGeometryDefinition>;
+//# sourceMappingURL=preset-shape-definitions-chart-marks.d.ts.map

package/dist/geometry/preset-shape-definitions-chart-marks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-shape-definitions-chart-marks.d.ts","sourceRoot":"","sources":["../../src/geometry/preset-shape-definitions-chart-marks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAEX,6BAA6B,EAC7B,MAAM,qCAAqC,CAAC;AAsF7C,4EAA4E;AAC5E,eAAO,MAAM,6BAA6B,EAAE,MAAM,CAAC,MAAM,EAAE,6BAA6B,CAIvF,CAAC"}

package/dist/geometry/preset-shape-definitions-cloud-callout.d.ts

@@ -0,0 +1,28 @@
+/**
+ * ECMA-376 ST_ShapeType preset geometry for `cloudCallout`.
+ *
+ * `cloudCallout` is a real `ST_ShapeType` member (ISO/IEC 29500-1 section
+ * 20.1.10.55) that was missing from `PRESET_SHAPE_GEOMETRY_TABLE`, so it
+ * degraded to the adjustment-blind polygon in `preset-shape-clip-paths.ts`.
+ * This module transcribes the canonical `presetShapeDefinitions.xml` entry
+ * verbatim:
+ *
+ *   - `adj1` / `adj2` place the callout tail target relative to the centre
+ *     (defaults -20833 / 62500, i.e. below and to the left);
+ *   - the first sub-path is the cloud body, an eleven-arc chain authored in
+ *     the legacy 43200x43200 drawing grid (the evaluator maps that space onto
+ *     the shape box via `PresetPath.w` / `PresetPath.h`);
+ *   - three single-arc sub-paths draw the shrinking tail bubbles, positioned
+ *     by the `g*` guide chain in SHAPE space (no path space declared);
+ *   - the final `fill="none"` sub-path is the scalloped outline overlay.
+ *
+ * The guide chain exercises `cat2` / `sat2` / `mod` / `at2`, all of which
+ * follow the ECMA operand order in `guide-formula-eval.ts`.
+ *
+ * Aggregated into `PRESET_SHAPE_GEOMETRY_TABLE` by
+ * `preset-shape-definitions-table.ts`.
+ */
+import type { PresetShapeGeometryDefinition } from './preset-shape-definitions-table.js';
+/** `cloudCallout` preset definition, keyed by its ECMA-376 ST_ShapeType name. */
+export declare const CLOUD_CALLOUT_PRESET_DEFINITIONS: Record<string, PresetShapeGeometryDefinition>;
+//# sourceMappingURL=preset-shape-definitions-cloud-callout.d.ts.map

package/dist/geometry/preset-shape-definitions-cloud-callout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-shape-definitions-cloud-callout.d.ts","sourceRoot":"","sources":["../../src/geometry/preset-shape-definitions-cloud-callout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,qCAAqC,CAAC;AAkIzF,iFAAiF;AACjF,eAAO,MAAM,gCAAgC,EAAE,MAAM,CAAC,MAAM,EAAE,6BAA6B,CAE1F,CAAC"}

package/dist/geometry/preset-shape-definitions-connectors-brackets.d.ts

@@ -0,0 +1,37 @@
+/**
+ * ECMA-376 ST_ShapeType preset geometry definitions — curved connectors
+ * (`curvedConnector2`/`3`/`4`/`5`) and bracket / brace primitives
+ * (`leftBracket`, `rightBracket`, `leftBrace`, `rightBrace`, `bracketPair`,
+ * `bracePair`).
+ *
+ * Connectors are stroke-only paths (`fill: 'none'`, `stroke: true`) that draw
+ * smooth cubic-bezier curves between their endpoints. The number of explicit
+ * adjustment values matches the count of intermediate control points along
+ * the curve (none, one, two, three) — so `curvedConnector2` is a fixed
+ * S-curve while `curvedConnector5` exposes three midpoint adjustments.
+ *
+ * Brackets and braces are SOLID closed outlines, not stroked-only forms.
+ * They are drawn by tracing a thin rounded-corner shape that visually reads
+ * as a `[`, `]`, `{` or `}`. Each shape uses one or two adjustment values:
+ *
+ *   leftBracket / rightBracket — adj1: corner radius (1/100000 of ss)
+ *   leftBrace   / rightBrace   — adj1: middle pinch position (vertical %)
+ *                                 adj2: corner radius (1/100000 of ss)
+ *   bracketPair                 — adj1: corner radius (shared)
+ *   bracePair                   — adj1: corner radius (shared)
+ *
+ * All formulas use only the documented operators implemented in
+ * `guide-formula-eval` (17 ops: +-, mul-div, pin, val, abs, sin, cos, at2,
+ * etc.) and the standard implicit guides published by `guide-formula-api`
+ * (l, t, r, b, hc, vc, wd2, hd2, ss, cd2, cd4, 3cd4, etc.).
+ *
+ * Aggregation into `PRESET_SHAPE_GEOMETRY_TABLE` is performed manually in
+ * `preset-shape-definitions-table.ts` once batch agents return.
+ */
+import type { PresetShapeGeometryDefinition } from './preset-shape-definitions-table.js';
+/**
+ * Connector + bracket preset definitions exported for manual aggregation
+ * into `PRESET_SHAPE_GEOMETRY_TABLE`. Keys are ECMA-376 ST_ShapeType names.
+ */
+export declare const CONNECTORS_BRACKETS_PRESET_DEFINITIONS: Record<string, PresetShapeGeometryDefinition>;
+//# sourceMappingURL=preset-shape-definitions-connectors-brackets.d.ts.map

package/dist/geometry/preset-shape-definitions-connectors-brackets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-shape-definitions-connectors-brackets.d.ts","sourceRoot":"","sources":["../../src/geometry/preset-shape-definitions-connectors-brackets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,qCAAqC,CAAC;AAwdzF;;;GAGG;AACH,eAAO,MAAM,sCAAsC,EAAE,MAAM,CAAC,MAAM,EAAE,6BAA6B,CAY/F,CAAC"}

package/dist/geometry/preset-shape-definitions-curved-arrows-connectors.d.ts

@@ -0,0 +1,43 @@
+/**
+ * ECMA-376 ST_ShapeType preset geometry definitions — lines + bent connectors
+ * batch.
+ *
+ * This batch authors 7 shapes whose geometry is defined in Microsoft's
+ * `presetShapeDefinitions.xml` (ISO/IEC 29500-1 §20.1.10.55). The curved
+ * arrows that once lived here (`curvedDownArrow`, `curvedLeftArrow`,
+ * `curvedUpArrow`) have been promoted to spec-exact transcriptions in
+ * `preset-shape-definitions-curved-arrows-exact.ts`.
+ *
+ * Lines (filled silhouettes are not applicable; stroke-only paths)
+ *  • `line`        — straight horizontal stroke (top-left → bottom-right)
+ *  • `lineInv`     — inverse diagonal stroke (top-right → bottom-left)
+ *
+ * Connectors (stroke-only polylines, `fill: 'none'`)
+ *  • `straightConnector1` — single segment (l/t → r/b)
+ *  • `bentConnector2`     — right-angle, 2 segments
+ *  • `bentConnector3`     — right-angle, 3 segments, 1 adjustment
+ *  • `bentConnector4`     — right-angle, 4 segments, 2 adjustments
+ *  • `bentConnector5`     — right-angle, 5 segments, 3 adjustments
+ *
+ * # Notes on faithfulness
+ *
+ * Connectors carry `fill: 'none', stroke: true` on every path. The path
+ * commands describe the polyline that PowerPoint draws between the connector
+ * endpoints; the bend positions are controlled by the `adjN` adjustment list
+ * exactly as documented in §20.1.9.10–20.1.9.13.
+ *
+ * # Adding to the master table
+ *
+ * The aggregator that exports `PRESET_SHAPE_GEOMETRY_TABLE` lives in
+ * `preset-shape-definitions-table.ts`. Spread
+ * `CURVED_ARROWS_CONNECTORS_PRESET_DEFINITIONS` into the master record after
+ * the human-driven merge of all batch agents.
+ */
+import type { PresetShapeGeometryDefinition } from './preset-shape-definitions-table.js';
+/**
+ * Curved arrow + connector preset definitions. The aggregator in
+ * `preset-shape-definitions-table.ts` should spread this record into
+ * `PRESET_SHAPE_GEOMETRY_TABLE` once all batch authors have merged.
+ */
+export declare const CURVED_ARROWS_CONNECTORS_PRESET_DEFINITIONS: Record<string, PresetShapeGeometryDefinition>;
+//# sourceMappingURL=preset-shape-definitions-curved-arrows-connectors.d.ts.map

package/dist/geometry/preset-shape-definitions-curved-arrows-connectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-shape-definitions-curved-arrows-connectors.d.ts","sourceRoot":"","sources":["../../src/geometry/preset-shape-definitions-curved-arrows-connectors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,qCAAqC,CAAC;AA0LzF;;;;GAIG;AACH,eAAO,MAAM,2CAA2C,EAAE,MAAM,CAC/D,MAAM,EACN,6BAA6B,CAS7B,CAAC"}

package/dist/geometry/preset-shape-definitions-curved-arrows-exact.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Spec-exact ECMA-376 / ISO-IEC-29500-1 preset geometry for the four curved
+ * arrows: `curvedRightArrow`, `curvedLeftArrow`, `curvedUpArrow`, and
+ * `curvedDownArrow`.
+ *
+ * These replace the earlier default-adjustment silhouettes (quad-Bezier
+ * reductions in `preset-shape-definitions-curved-arrows-connectors.ts` and a
+ * cubic-Bezier approximation in `preset-shape-definitions-arrows-refined.ts`).
+ * The `avLst`, `gdLst`, `rect`, and `pathLst` below are transcribed verbatim
+ * from Microsoft's authoritative `presetShapeDefinitions.xml`
+ * (ISO/IEC 29500-1 §20.1.10.55), sourced from the Apache POI mirror
+ * `poi/src/main/resources/org/apache/poi/sl/draw/geom/presetShapeDefinitions.xml`.
+ *
+ * There are no deviations from the canonical token stream: every operator here
+ * (including `at2`, whose ECMA operand order is `at2 x y = atan2(y, x)`) is
+ * evaluated exactly as ISO/IEC 29500-1 section 20.1.9.6 specifies by
+ * `guide-formula-eval.ts`.
+ *
+ * The aggregator in `preset-shape-definitions-table.ts` spreads
+ * `EXACT_CURVED_ARROW_PRESET_DEFINITIONS` last so these authoritative entries
+ * win over any earlier simplified/refined registrations for the same names.
+ */
+import type { PresetShapeGeometryDefinition } from './preset-shape-definitions-table.js';
+/**
+ * Spec-exact curved-arrow preset definitions. Spread LAST in
+ * `preset-shape-definitions-table.ts` so they override the earlier simplified
+ * and refined registrations for the same four shape names.
+ */
+export declare const EXACT_CURVED_ARROW_PRESET_DEFINITIONS: Record<string, PresetShapeGeometryDefinition>;
+//# sourceMappingURL=preset-shape-definitions-curved-arrows-exact.d.ts.map

package/dist/geometry/preset-shape-definitions-curved-arrows-exact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-shape-definitions-curved-arrows-exact.d.ts","sourceRoot":"","sources":["../../src/geometry/preset-shape-definitions-curved-arrows-exact.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,qCAAqC,CAAC;AAmYzF;;;;GAIG;AACH,eAAO,MAAM,qCAAqC,EAAE,MAAM,CAAC,MAAM,EAAE,6BAA6B,CAM9F,CAAC"}

package/dist/geometry/preset-shape-definitions-flowchart.d.ts

@@ -0,0 +1,29 @@
+/**
+ * ECMA-376 ST_ShapeType preset geometry definitions — flowchart family.
+ *
+ * Mirrors Microsoft's `presetShapeDefinitions.xml` for every `flowChart*`
+ * shape catalogued in ISO/IEC 29500-1 §20.1.10.55 (all 29 of them), plus the
+ * non-spec `flowChartStoredData` alias PowerPoint's UI exposes for
+ * `flowChartOnlineStorage`. The data here is authored using the same
+ * conventions as `preset-shape-definitions-table.ts`; see that module's header
+ * comment for the full procedure (each `<a:gd>` is captured verbatim, every
+ * `<a:path>` child becomes a `PresetPathCommand`, coordinates are
+ * guide-formula tokens).
+ *
+ * None of the flowchart shapes have an `avLst` (no user adjustments) so all
+ * `gdLst` entries are deterministic — the geometry depends only on the
+ * implicit guides (`l`, `t`, `r`, `b`, `w`, `h`, `hc`, `vc`, `wd2`, `hd2`,
+ * `ss`, `ssd2`, ...) and inline literals.
+ */
+import type { PresetShapeGeometryDefinition } from './preset-shape-definitions-table.js';
+/**
+ * Master table of populated flowchart preset geometries. Will be merged into
+ * `PRESET_SHAPE_GEOMETRY_TABLE` by the integration step. Keyed by ECMA-376
+ * ST_ShapeType name.
+ *
+ * Note: ECMA defines `flowChartDisplay` (display shape) — exposed below via
+ * the requested `flowChartDisplayValue` alias to match the agent task spec
+ * which lists `flowChartDisplayValue`.
+ */
+export declare const FLOWCHART_PRESET_DEFINITIONS: Record<string, PresetShapeGeometryDefinition>;
+//# sourceMappingURL=preset-shape-definitions-flowchart.d.ts.map

package/dist/geometry/preset-shape-definitions-flowchart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-shape-definitions-flowchart.d.ts","sourceRoot":"","sources":["../../src/geometry/preset-shape-definitions-flowchart.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,qCAAqC,CAAC;AAqzBzF;;;;;;;;GAQG;AACH,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAAC,MAAM,EAAE,6BAA6B,CA+BtF,CAAC"}

package/dist/geometry/preset-shape-definitions-gear6.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Spec-exact ECMA-376 / ISO-IEC-29500-1 preset geometry for `gear6`
+ * (ISO/IEC 29500-1 section 20.1.10.55).
+ *
+ * Transcribed verbatim from Microsoft's authoritative
+ * `presetShapeDefinitions.xml`, sourced from the Apache POI mirror
+ * `poi/src/main/resources/org/apache/poi/sl/draw/geom/presetShapeDefinitions.xml`
+ * (fetched 2026-09-05). This replaces the earlier hand-rolled `buildGearN`
+ * trapezoid-tooth approximation in `preset-shape-definitions-tabs-decorations.ts`,
+ * which computed tooth/valley vertices from a precomputed trig table and never
+ * consumed `adj2` (COM-verified 2026-09-05: `Shape.Adjustments.Count` is 2, not
+ * 1). The spec-exact path below routes every tooth root through an `arcTo`
+ * whose radius is `(rw, rh)` (the shape's bounding ellipse shrunk by the tooth
+ * depth `th`, itself derived from `adj1`); the fillet PowerPoint renders
+ * between adjacent teeth is exactly this root-circle arc, and its span
+ * (`swAng1`/`swAng2`) narrows as `adj2` (`lFD`, the flank offset) grows, which
+ * is how real PowerPoint's `adj2` fillet radius reaches the silhouette: a
+ * larger `adj2` widens the flat root land (`xE`/`xF` points) and shortens the
+ * fillet arc's sweep, visually rounding the tooth-to-root transition.
+ *
+ * No deviations from the canonical token stream: every operator here
+ * (`pin`, mul-div, `+-`, `+/`, `?:`, `at2`, `cos`, `sin`, `mod`) is evaluated
+ * exactly as ISO/IEC 29500-1 section 20.1.9.11 specifies by
+ * `guide-formula-eval.ts`; `at2`'s ECMA operand order (`at2 x y = atan2(y, x)`)
+ * matches `preset-shape-definitions-curved-arrows-exact.ts`'s documented
+ * convention. The guide name `a1`/`a2` is intentionally reused mid-list (once
+ * as the pinned `adj1`/`adj2` value, later as an arm's polar angle): guides
+ * evaluate in array order into a single mutable map, so the later definition
+ * shadows the earlier one for every formula after it, matching
+ * `evaluateGuides` in `guide-formula-api.ts`.
+ *
+ * `preset-shape-definitions-table.ts` imports `gear6` from here (and `gear9`
+ * from the sibling `preset-shape-definitions-gear9.ts`) instead of the old
+ * `buildGearN` export in `preset-shape-definitions-tabs-decorations.ts`.
+ */
+import type { PresetShapeGeometryDefinition } from './preset-shape-definitions-table.js';
+export declare const gear6: PresetShapeGeometryDefinition;
+//# sourceMappingURL=preset-shape-definitions-gear6.d.ts.map

package/dist/geometry/preset-shape-definitions-gear6.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-shape-definitions-gear6.d.ts","sourceRoot":"","sources":["../../src/geometry/preset-shape-definitions-gear6.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,qCAAqC,CAAC;AAOzF,eAAO,MAAM,KAAK,EAAE,6BAiJnB,CAAC"}

package/dist/geometry/preset-shape-definitions-gear9.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Spec-exact ECMA-376 / ISO-IEC-29500-1 preset geometry for `gear9`
+ * (ISO/IEC 29500-1 section 20.1.10.55).
+ *
+ * Sibling of `preset-shape-definitions-gear6.ts`; see that file's header for
+ * the `adj2` fillet explanation, the guide-name-reuse note, and the
+ * transcription source. `gear9`'s gdLst is longer because the spec author
+ * hand-unrolled all 9 teeth rather than looping: arms 1-4 (and 9) derive their
+ * tip/root points from full ellipse-intersection trig (`cos`/`sin`/`at2`/`mod`),
+ * while arms 5-8 mirror an earlier arm's points across the shape's vertical
+ * centre (`+- w 0 x..`) since `gear9` is symmetric about that axis. This is
+ * transcribed as-is (not generalised into a loop) so it stays line-for-line
+ * auditable against the source XML.
+ *
+ * The 242-entry gdLst is authored as a `name|formula` table (one XML `<a:gd>`
+ * per line) rather than 242 individual `gd(...)` calls: oxfmt reflows an
+ * array literal to one element per line regardless of source packing, which
+ * would push this file over the repo's 300-LOC-per-file budget. A template
+ * string is not reformatted, so the table stays exactly as auditable against
+ * the source XML while keeping the file short.
+ */
+import type { PresetShapeGeometryDefinition } from './preset-shape-definitions-table.js';
+export declare const gear9: PresetShapeGeometryDefinition;
+//# sourceMappingURL=preset-shape-definitions-gear9.d.ts.map

package/dist/geometry/preset-shape-definitions-gear9.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-shape-definitions-gear9.d.ts","sourceRoot":"","sources":["../../src/geometry/preset-shape-definitions-gear9.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,qCAAqC,CAAC;AAuFzF,eAAO,MAAM,KAAK,EAAE,6BAiDnB,CAAC"}

package/dist/geometry/preset-shape-definitions-misc.d.ts

@@ -0,0 +1,38 @@
+/**
+ * ECMA-376 ST_ShapeType preset geometry definitions — miscellaneous shapes.
+ *
+ * This module supplies definitions for ~30 additional preset shapes outside
+ * the first-cut table in `preset-shape-definitions-table.ts`:
+ *
+ * - **N-pointed stars** (`star6`, `star7`, `star8`, `star10`, `star12`,
+ *   `star16`, `star24`, `star32`) generalising the `star4` / `star5`
+ *   construction. Each is a regular polygon whose 2N vertices alternate
+ *   between an outer ellipse `(wd2, hd2)` and an inner ellipse scaled by
+ *   `adj/50000`.
+ * - **Ribbons & banners** (`ribbon`, `ribbon2`, `ellipseRibbon`,
+ *   `ellipseRibbon2`, `leftRightRibbon`).
+ * - **Callouts** (`callout1`–`callout3`, `borderCallout1`–`borderCallout3`)
+ *   with separate stroke-only leader lines.
+ * - **Decorations** (`cloud`, `smileyFace`, `lightningBolt`, `sun`, `moon`).
+ * - **Math symbols** (`mathPlus`, `mathMinus`, `mathMultiply`, `mathDivide`,
+ *   `mathEqual`, `mathNotEqual`).
+ * - **Heart + irregular seals** (`heart`, `irregularSeal1`, `irregularSeal2`).
+ *
+ * Some shapes (notably `cloud`, `smileyFace`, `lightningBolt`, `mathDivide`,
+ * `irregularSeal*`) deviate from the ECMA reference's exact gdLst because
+ * those formulas use complex bezier offsets keyed off implicit angle tables
+ * that would balloon the file. In those cases we fall back to the
+ * default-adjustment polygon / bezier shape — visually faithful at the
+ * default avLst values but adjustment-insensitive. Each such fallback is
+ * called out in a comment on the definition.
+ *
+ * Aggregation into `PRESET_SHAPE_GEOMETRY_TABLE` is performed manually in
+ * `preset-shape-definitions-table.ts` after batch agents return.
+ */
+import type { PresetShapeGeometryDefinition } from './preset-shape-definitions-table.js';
+/**
+ * Miscellaneous preset definitions exported for manual aggregation into
+ * `PRESET_SHAPE_GEOMETRY_TABLE`. Keys are ECMA-376 ST_ShapeType names.
+ */
+export declare const MISC_PRESET_DEFINITIONS: Record<string, PresetShapeGeometryDefinition>;
+//# sourceMappingURL=preset-shape-definitions-misc.d.ts.map

package/dist/geometry/preset-shape-definitions-misc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-shape-definitions-misc.d.ts","sourceRoot":"","sources":["../../src/geometry/preset-shape-definitions-misc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,KAAK,EAGX,6BAA6B,EAC7B,MAAM,qCAAqC,CAAC;AAgzC7C;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,6BAA6B,CAkCjF,CAAC"}

package/dist/geometry/preset-shape-definitions-rects-snips.d.ts

@@ -0,0 +1,28 @@
+/**
+ * ECMA-376 ST_ShapeType preset geometry definitions — rounded / snipped
+ * rectangles + foldedCorner / teardrop / corner.
+ *
+ * This batch authors the rectangle-corner family of presets defined in
+ * Microsoft's `presetShapeDefinitions.xml` (ISO/IEC 29500-1 §20.1.10.55):
+ *
+ *  • `round1Rect`       — 1 rounded corner (top-right). adj1 = radius/ss.
+ *  • `round2SameRect`   — 2 same-side rounded corners (top). adj1 + adj2.
+ *  • `round2DiagRect`   — 2 diagonal rounded corners (TL + BR). adj1 + adj2.
+ *  • `snipRoundRect`    — 1 snipped (TL) + 1 rounded (TR). adj1 + adj2.
+ *  • `snip1Rect`        — 1 chamfered corner (TR). adj1.
+ *  • `snip2SameRect`    — 2 same-side chamfered corners (top). adj1 + adj2.
+ *  • `snip2DiagRect`    — 2 diagonal chamfered corners (TR + BL). adj1 + adj2.
+ *  • `foldedCorner`     — rectangle with a folded BR corner. adj1.
+ *  • `teardrop`         — circle with a stretchable top-right point. adj1.
+ *  • `corner`           — L-shape with adj1 (height) + adj2 (width).
+ *
+ * Tokens inside guide formulas and path commands are raw OOXML strings — the
+ * `preset-shape-evaluator` resolves them via `guide-formula-eval`. All
+ * adjustment defaults match the canonical XML.
+ *
+ * Aggregation into `PRESET_SHAPE_GEOMETRY_TABLE` is performed manually in
+ * `preset-shape-definitions-table.ts` after batch agents return.
+ */
+import type { PresetShapeGeometryDefinition } from './preset-shape-definitions-table.js';
+export declare const RECTS_SNIPS_PRESET_DEFINITIONS: Record<string, PresetShapeGeometryDefinition>;
+//# sourceMappingURL=preset-shape-definitions-rects-snips.d.ts.map

package/dist/geometry/preset-shape-definitions-rects-snips.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-shape-definitions-rects-snips.d.ts","sourceRoot":"","sources":["../../src/geometry/preset-shape-definitions-rects-snips.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,qCAAqC,CAAC;AA8ZzF,eAAO,MAAM,8BAA8B,EAAE,MAAM,CAAC,MAAM,EAAE,6BAA6B,CAWxF,CAAC"}