ooxml-core 0.2.0

package/dist/geometry/com-avlst-ground-truth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"com-avlst-ground-truth.d.ts","sourceRoot":"","sources":["../../src/geometry/com-avlst-ground-truth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,sEAAsE;AACtE,MAAM,WAAW,wBAAwB;IACxC,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,eAAO,MAAM,sBAAsB,EAAE,wBAAwB,EAyB5D,CAAC"}

package/dist/geometry/connector-elbow-geometry.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Horizontal-first bend geometry helpers for multi-segment connectors.
+ * OOXML preset paths keep x as the primary axis regardless of aspect ratio;
+ * transform flips reverse the endpoints when the shape is mirrored.
+ */
+/** Segment counts implied by the `bentConnector*` / `curvedConnector*` preset names. */
+export type ElbowSegments = 3 | 4 | 5;
+/** One `(x, y)` waypoint. */
+export type ElbowPoint = readonly [number, number];
+/** One cubic-Bezier segment: a single control point (used twice) and an end point. */
+export interface ElbowCurveSegment {
+    control: ElbowPoint;
+    end: ElbowPoint;
+}
+/**
+ * OOXML bent and curved connector presets are authored horizontal-first.
+ * Their orientation is controlled by transform flips, not box aspect ratio.
+ */
+export declare function isHorizontalPrimaryAxis(_width: number, _height: number): boolean;
+/**
+ * Compute the bend waypoints (including the two endpoints) for a
+ * `segments`-segment orthogonal elbow between `(startX,startY)` and
+ * `(endX,endY)`, honouring `adj1`/`adj2`/`adj3` fractions (already
+ * normalised to 0..1 by `getConnectorAdjustment`).
+ *
+ * Segment counts mirror the OOXML presets:
+ * - `3` (`bentConnector3`, Z-shape): one bend line, positioned by `adj1`.
+ * - `4` (`bentConnector4`): a staircase through `adj1` (primary axis) and
+ *   `adj2` (secondary axis).
+ * - `5` (`bentConnector5`): a staircase with two primary-axis bend lines
+ *   (`adj1`, `adj3`) joined by one secondary-axis crossing (`adj2`).
+ */
+export declare function elbowWaypoints(startX: number, startY: number, endX: number, endY: number, width: number, height: number, segments: ElbowSegments, adj1: number, adj2: number, adj3: number): ElbowPoint[];
+/**
+ * Compute the cubic-Bezier segments (control point used twice, plus an end
+ * point) for a `segments`-segment smooth elbow, mirroring
+ * {@link elbowWaypoints}'s fixed axis and adjustment handling. `segments`
+ * yields `segments - 1` curve segments.
+ */
+export declare function elbowCurveSegments(startX: number, startY: number, endX: number, endY: number, width: number, height: number, segments: ElbowSegments, adj1: number, adj2: number, adj3: number): ElbowCurveSegment[];
+//# sourceMappingURL=connector-elbow-geometry.d.ts.map

package/dist/geometry/connector-elbow-geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector-elbow-geometry.d.ts","sourceRoot":"","sources":["../../src/geometry/connector-elbow-geometry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,wFAAwF;AACxF,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAEtC,6BAA6B;AAC7B,MAAM,MAAM,UAAU,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEnD,sFAAsF;AACtF,MAAM,WAAW,iBAAiB;IACjC,OAAO,EAAE,UAAU,CAAC;IACpB,GAAG,EAAE,UAAU,CAAC;CAChB;AAYD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAEhF;AAmBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAC7B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,aAAa,EACvB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACV,UAAU,EAAE,CA6Bd;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CACjC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,aAAa,EACvB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACV,iBAAiB,EAAE,CAkCrB"}

package/dist/geometry/guide-formula-api.d.ts

@@ -0,0 +1,55 @@
+/**
+ * OOXML DrawingML guide formula evaluator — public API.
+ *
+ * Built-in variable seeding, guide evaluation, adjustment parsing,
+ * and coordinate resolution.
+ */
+import type { GeometryGuide, GeometryContext } from './guide-formula-eval.js';
+/**
+ * Seed the built-in variables for a shape of the given dimensions.
+ *
+ * Built-in variables are defined by the OOXML spec (ISO/IEC 29500-1 section 20.1.9):
+ * - **Position/size:** `w`, `h`, `l`, `t`, `r`, `b`, `hc` (horizontal center), `vc` (vertical center)
+ * - **Width fractions:** `wd2` through `wd32` (width divided by the standard divisors)
+ * - **Height fractions:** `hd2` through `hd32` (height divided by the standard divisors)
+ * - **Short/long side:** `ss`, `ls`, `ssd2` through `ssd32`
+ * - **Angular constants:** `cd2` (180 degrees), `cd4` (90 degrees), `cd8` (45 degrees), etc.
+ *
+ * All angular values are in OOXML angle units (60,000ths of a degree).
+ *
+ * @param ctx - Shape dimensions (width and height).
+ * @returns A Map of built-in variable names to their computed values.
+ */
+export declare function createBuiltinVariables(ctx: GeometryContext): Map<string, number>;
+/**
+ * Evaluate a list of geometry guides in order, resolving each guide's
+ * formula against the accumulated variable context.
+ *
+ * @param guides - Ordered list of guide definitions from `a:gdLst` or `a:avLst`.
+ * @param ctx - Shape dimensions for built-in variables.
+ * @param adjustments - Optional adjustment values (from `a:avLst`), pre-seeded.
+ * @returns A Map of all resolved variable names → numeric values.
+ */
+export declare function evaluateGuides(guides: GeometryGuide[], ctx: GeometryContext, adjustments?: Map<string, number>): Map<string, number>;
+/**
+ * Parse `a:gd` XML elements into GeometryGuide array.
+ *
+ * @param gdNodes - Array of guide definition XML objects with `@_name` and `@_fmla` attributes.
+ * @returns Ordered list of parsed guide definitions.
+ */
+export declare function parseGuideDefinitions(gdNodes: ReadonlyArray<Record<string, unknown>>): GeometryGuide[];
+/**
+ * Parse adjustment values from `a:avLst/a:gd` into a Map.
+ *
+ * Each adjustment guide has a formula typically of the form `val <number>`.
+ * This extracts the adjustment name and its numeric value.
+ */
+export declare function parseAdjustmentValues(gdNodes: ReadonlyArray<Record<string, unknown>>): Map<string, number>;
+/**
+ * Resolve a coordinate value that may be a guide name or a numeric literal.
+ *
+ * In OOXML geometry paths, coordinates like `x` and `y` in `a:pt` can be
+ * either numeric literals or references to guide variable names.
+ */
+export declare function resolveCoordinate(value: string | number | undefined, variables: Map<string, number>): number;
+//# sourceMappingURL=guide-formula-api.d.ts.map

package/dist/geometry/guide-formula-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guide-formula-api.d.ts","sourceRoot":"","sources":["../../src/geometry/guide-formula-api.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAa9E;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,eAAe,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAkDhF;AAMD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC7B,MAAM,EAAE,aAAa,EAAE,EACvB,GAAG,EAAE,eAAe,EACpB,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAkBrB;AAMD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACpC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC7C,aAAa,EAAE,CAUjB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACpC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC7C,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CA+BrB;AAMD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAChC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,EAClC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC5B,MAAM,CAiBR"}

package/dist/geometry/guide-formula-eval.d.ts

@@ -0,0 +1,85 @@
+/**
+ * OOXML DrawingML guide formula evaluator — core types and evaluation.
+ *
+ * Implements the formula system defined in ISO/IEC 29500-1 §20.1.9.11 (fmla)
+ * for `a:gd` guide definitions used in preset and custom geometries.
+ */
+/**
+ * A single guide definition parsed from an `a:gd` XML element.
+ *
+ * Guides are named variables whose values are computed by evaluating
+ * a formula expression against the current variable context.
+ */
+export interface GeometryGuide {
+    /** Guide variable name (e.g. `"adj"`, `"g0"`, `"x1"`). */
+    name: string;
+    formula: string;
+}
+/** Shape dimensions used as built-in variables for formula evaluation. */
+export interface GeometryContext {
+    /** Shape width in EMU. */
+    w: number;
+    /** Shape height in EMU. */
+    h: number;
+}
+/**
+ * Internal representation of a parsed formula: an operator token
+ * followed by zero or more operand tokens (either numeric literals
+ * or variable references).
+ */
+interface ParsedFormula {
+    op: string;
+    /** Operand tokens — numeric literal strings or variable names. */
+    args: string[];
+}
+/**
+ * OOXML angle unit scale factor.
+ *
+ * OOXML represents angles in 60,000ths of a degree (e.g. 5400000 = 90 degrees).
+ */
+export declare const ANGLE_SCALE = 60000;
+/**
+ * Convert an OOXML angle value (in 60,000ths of a degree) to radians.
+ *
+ * @param ooxmlAngle - Angle in OOXML units (60,000ths of a degree).
+ * @returns The equivalent angle in radians.
+ */
+export declare function angleToRadians(ooxmlAngle: number): number;
+/**
+ * Parse a raw formula string into its operator and argument tokens.
+ *
+ * Formula strings are whitespace-separated tokens where the first token
+ * is the operator and the rest are operands. For example:
+ * `"*\/ w adj 100000"` parses to `{ op: "*\/", args: ["w", "adj", "100000"] }`.
+ *
+ * @param fmla - The raw formula string from the `@_fmla` XML attribute.
+ * @returns The parsed formula with operator and argument tokens.
+ */
+export declare function parseFormula(fmla: string): ParsedFormula;
+/**
+ * Resolve a single operand token to a numeric value.
+ *
+ * The token is first tested as a numeric literal. If that fails,
+ * it is looked up as a variable name in the provided context.
+ * Unknown variables resolve to 0 defensively.
+ *
+ * @param token - A numeric literal string or variable name.
+ * @param variables - The current variable context.
+ * @returns The resolved numeric value.
+ */
+export declare function resolveOperand(token: string, variables: Map<string, number>): number;
+/**
+ * Evaluate a single parsed formula against the current variable context.
+ *
+ * Implements all OOXML DrawingML formula operators as defined in
+ * ISO/IEC 29500-1 section 20.1.9.11, including arithmetic (`+-`, `*\/`, `+/`),
+ * trigonometric (`sin`, `cos`, `tan`, `atan`, `at2`), conditional (`?:`),
+ * clamping (`pin`), modulus (`mod`), and combined trig functions (`cat2`, `sat2`).
+ *
+ * @param parsed - The parsed formula (operator + argument tokens).
+ * @param vars - The current variable context (guide names mapped to values).
+ * @returns The computed numeric result.
+ */
+export declare function evaluateFormula(parsed: ParsedFormula, vars: Map<string, number>): number;
+export {};
+//# sourceMappingURL=guide-formula-eval.d.ts.map

package/dist/geometry/guide-formula-eval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guide-formula-eval.d.ts","sourceRoot":"","sources":["../../src/geometry/guide-formula-eval.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC7B,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IAEb,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,0EAA0E;AAC1E,MAAM,WAAW,eAAe;IAC/B,0BAA0B;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,2BAA2B;IAC3B,CAAC,EAAE,MAAM,CAAC;CACV;AAED;;;;GAIG;AACH,UAAU,aAAa;IAEtB,EAAE,EAAE,MAAM,CAAC;IACX,kEAAkE;IAClE,IAAI,EAAE,MAAM,EAAE,CAAC;CACf;AAMD;;;;GAIG;AACH,eAAO,MAAM,WAAW,QAAQ,CAAC;AAEjC;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAGzD;AAMD;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAKxD;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAepF;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAuIxF"}