@paperjsx/json-to-pptx-pro 0.0.1

package/dist-pro/types/pvce/src/charts/color-pipeline.d.ts

@@ -0,0 +1,149 @@
+/**
+ * PVCE Color Pipeline
+ * ===================
+ * Document 4: Print-Specific Color & Accessible Data Structures
+ *
+ * Features:
+ * - Section 2: Dual-mode color (RGB/CMYK/Monochrome)
+ * - Section 3: Deterministic pattern overlays
+ * - Section 4: WCAG contrast checking
+ * - Perceptual luminance calculations
+ */
+import { UnifiedColor, ColorPalette, PatternDefinition, ColorMode } from "./types.js";
+/** WCAG minimum contrast ratios */
+export declare const WCAG_CONTRAST: {
+    readonly AA_NORMAL: 4.5;
+    readonly AA_LARGE: 3;
+    readonly AAA_NORMAL: 7;
+    readonly AAA_LARGE: 4.5;
+};
+/** Minimum grayscale difference between series (Doc 4, Section 2: 15%) */
+export declare const MIN_GRAY_DIFFERENCE = 15;
+/**
+ * Default PVCE palette - designed for both screen and print.
+ * Colors are chosen for:
+ * - High contrast ratios (WCAG AA against white: 4.5:1 minimum)
+ * - Distinct grayscale values (min 15% difference)
+ * - Clean CMYK conversion
+ */
+export declare const DEFAULT_PALETTE_COLORS: string[];
+/**
+ * Colorblind-safe palette (Deuteranopia/Protanopia friendly).
+ */
+export declare const COLORBLIND_SAFE_COLORS: string[];
+/**
+ * Monochrome palette with well-distributed grayscale values.
+ * Each color is chosen to have at least 15% difference from adjacent colors.
+ * Values range from very dark (10%) to light (80%).
+ */
+export declare const MONOCHROME_PALETTE_COLORS: string[];
+/**
+ * ColorPipeline - Manages color transformations for print and screen.
+ *
+ * Doc 4 Compliance:
+ * - Section 2: RGB to CMYK and Grayscale conversion
+ * - Section 3: Deterministic pattern assignment
+ * - Contrast ratio calculation
+ */
+export declare class ColorPipeline {
+    private colorMode;
+    private enablePatterns;
+    private customPalette?;
+    constructor(options?: {
+        colorMode?: ColorMode;
+        enablePatterns?: boolean;
+        palette?: string[];
+    });
+    /**
+     * Set the color mode (rgb, cmyk, or monochrome).
+     */
+    setColorMode(mode: ColorMode): void;
+    /**
+     * Enable/disable pattern overlays for accessibility.
+     */
+    setPatternMode(enabled: boolean): void;
+    /**
+     * Convert a hex color to UnifiedColor with all representations.
+     */
+    parseColor(hex: string): UnifiedColor;
+    /**
+     * Get the appropriate color value based on current mode.
+     */
+    getColor(color: UnifiedColor): string;
+    /**
+     * Get color for a series index from the palette.
+     */
+    getSeriesColor(seriesIndex: number): UnifiedColor;
+    /**
+     * Get pattern definition for a series (Doc 4, Section 3).
+     * Patterns are deterministically mapped to series index.
+     */
+    getSeriesPattern(seriesIndex: number): PatternDefinition;
+    /**
+     * Check if patterns should be used (>3 series or monochrome mode).
+     */
+    shouldUsePatterns(seriesCount: number): boolean;
+    /**
+     * Generate a complete color palette with patterns.
+     */
+    createPalette(seriesCount: number, name?: string): ColorPalette;
+    /**
+     * Calculate contrast ratio between two colors (WCAG formula).
+     */
+    getContrastRatio(color1: UnifiedColor, color2: UnifiedColor): number;
+    /**
+     * Check if two colors have sufficient contrast for text.
+     */
+    hasAdequateContrast(foreground: UnifiedColor, background: UnifiedColor, isLargeText?: boolean): boolean;
+    /**
+     * Find a text color (black or white) with best contrast.
+     */
+    getTextColor(background: UnifiedColor): UnifiedColor;
+    /**
+     * Ensure grayscale values are distinct enough (Doc 4, Section 2).
+     * Returns adjusted colors if needed.
+     */
+    ensureGrayscaleDistinction(colors: UnifiedColor[]): UnifiedColor[];
+    private hexToRGB;
+    private rgbToHex;
+    /**
+     * Convert RGB to CMYK using standard formulas.
+     * Doc 4, Section 2: ICC Color Profiles support.
+     */
+    private rgbToCMYK;
+    /**
+     * Convert RGB to Grayscale using perceptual luminance.
+     * Doc 4, Section 2: Deterministic Color-to-Gray Mapping.
+     */
+    private rgbToGrayscale;
+    private grayscaleToRGB;
+    private cmykToString;
+    private grayscaleToString;
+    /**
+     * Calculate relative luminance for WCAG contrast formula.
+     */
+    private getRelativeLuminance;
+    /**
+     * Check contrast between all adjacent colors in palette.
+     */
+    private checkPaletteContrast;
+}
+/** Global color pipeline instance */
+export declare const colorPipeline: ColorPipeline;
+/**
+ * Parse a hex color to unified format.
+ */
+export declare function parseColor(hex: string): UnifiedColor;
+/**
+ * Get contrast ratio between two hex colors.
+ */
+export declare function getContrastRatio(hex1: string, hex2: string): number;
+/**
+ * Check WCAG contrast compliance.
+ */
+export declare function meetsContrastRequirement(foregroundHex: string, backgroundHex: string, level?: "AA" | "AAA", isLargeText?: boolean): boolean;
+/**
+ * Create a monochrome-safe palette with patterns.
+ */
+export declare function createMonochromePalette(seriesCount: number): ColorPalette;
+//# sourceMappingURL=color-pipeline.d.ts.map

package/dist-pro/types/pvce/src/charts/color-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-pipeline.d.ts","sourceRoot":"","sources":["../../../../../../pvce/src/charts/color-pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAIL,YAAY,EACZ,YAAY,EACZ,iBAAiB,EAEjB,SAAS,EACV,MAAM,YAAY,CAAC;AAMpB,mCAAmC;AACnC,eAAO,MAAM,aAAa;;;;;CAKhB,CAAC;AAEX,0EAA0E;AAC1E,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAkBtC;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,EAW1C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,EAS1C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAAM,EAW7C,CAAC;AAMF;;;;;;;GAOG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,aAAa,CAAC,CAAW;gBAG/B,OAAO,GAAE;QACP,SAAS,CAAC,EAAE,SAAS,CAAC;QACtB,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;KACf;IAOR;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAInC;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAItC;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY;IAarC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM;IAWrC;;OAEG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY;IAUjD;;;OAGG;IACH,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,iBAAiB;IAkBxD;;OAEG;IACH,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAM/C;;OAEG;IACH,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,GAAE,MAAkB,GAAG,YAAY;IAqB1E;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM;IAUpE;;OAEG;IACH,mBAAmB,CACjB,UAAU,EAAE,YAAY,EACxB,UAAU,EAAE,YAAY,EACxB,WAAW,GAAE,OAAe,GAC3B,OAAO;IAQV;;OAEG;IACH,YAAY,CAAC,UAAU,EAAE,YAAY,GAAG,YAAY;IAUpD;;;OAGG;IACH,0BAA0B,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE;IAuClE,OAAO,CAAC,QAAQ;IAUhB,OAAO,CAAC,QAAQ;IAKhB;;;OAGG;IACH,OAAO,CAAC,SAAS;IAuBjB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,iBAAiB;IAKzB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAa5B;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAiB7B;AAMD,qCAAqC;AACrC,eAAO,MAAM,aAAa,eAAsB,CAAC;AAMjD;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAEpD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAInE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,EACrB,KAAK,GAAE,IAAI,GAAG,KAAY,EAC1B,WAAW,GAAE,OAAe,GAC3B,OAAO,CAWT;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,CAMzE"}

package/dist-pro/types/pvce/src/charts/compiler.d.ts

@@ -0,0 +1,155 @@
+/**
+ * PVCE (Precision-Vector Charting Engine) - Main Compiler
+ * =======================================================
+ *
+ * This is the core compiler that implements all four PVCE documents:
+ * - Doc 1: Deterministic Scene Graph & Compiler Architecture
+ * - Doc 2: Typographic Precision & Label Collision Logic
+ * - Doc 3: Sub-Pixel Vector Normalization & Scaling
+ * - Doc 4: Print-Specific Color & Accessible Data Structures
+ *
+ * The compiler follows a strict "Input to IR" pipeline:
+ * 1. Validate input
+ * 2. Calculate scales
+ * 3. Generate Scene Graph (IR)
+ * 4. Render to SVG
+ */
+import { ChartInput, ChartType, CompilationResult } from "./types.js";
+/** Compiler options */
+export interface CompilerOptions {
+    /** Output SVG width */
+    width?: number;
+    /** Output SVG height */
+    height?: number;
+    /** Font family for labels */
+    fontFamily?: string;
+    /** Base font size */
+    fontSize?: number;
+    /** Enable accessibility features */
+    accessibility?: boolean;
+    /** Enable monochrome mode */
+    monochrome?: boolean;
+    /** Enable pattern overlays */
+    patterns?: boolean;
+    /** Embed source data in XMP */
+    embedSourceData?: boolean;
+    /** Custom color palette */
+    palette?: string[];
+    /** Deterministic seed (auto-derived from data if not provided) */
+    seed?: number;
+    /** Pretty-print SVG output */
+    prettyPrint?: boolean;
+}
+/**
+ * PVCECompiler - The main charting engine compiler.
+ *
+ * Implements all requirements from Documents 1-4:
+ * - Pure function pipeline (Doc 1)
+ * - Glyph Oracle & collision detection (Doc 2)
+ * - SVG-first rendering with sub-pixel snapping (Doc 3)
+ * - Accessibility & color management (Doc 4)
+ */
+export declare class PVCECompiler {
+    private glyphOracle;
+    private collisionSolver;
+    private svgRenderer;
+    private colorPipeline;
+    private accessibilityGenerator;
+    private pathOptimizer;
+    private options;
+    private stats;
+    constructor(options?: CompilerOptions);
+    /**
+     * Compile a chart to Scene Graph and SVG.
+     * This is the main entry point - Doc 1, Section 2: The Pure-Function Pipeline.
+     */
+    compile<T>(chartType: ChartType, input: ChartInput<T>): CompilationResult;
+    /**
+     * Compile a bar chart.
+     */
+    private compileBarChart;
+    /**
+     * Compile a line chart with path optimization (Doc 3, Section 2).
+     */
+    private compileLineChart;
+    /**
+     * Compile a scatter chart with label collision detection (Doc 2, Section 4).
+     */
+    private compileScatterChart;
+    /**
+     * Compile a pie/donut chart with radial labeling (Doc 2, Section 5).
+     */
+    private compilePieChart;
+    /**
+     * Compile a waterfall chart.
+     */
+    private compileWaterfallChart;
+    /**
+     * Create X-axis labels with collision detection (Doc 2, Section 3).
+     */
+    private createXAxisLabels;
+    /**
+     * Create Y-axis labels (Doc 2: Fixed Gutter Strategy).
+     */
+    private createYAxisLabels;
+    /**
+     * Create grid lines.
+     */
+    private createGridLines;
+    private normalizeBarData;
+    private normalizeLineData;
+    private normalizeScatterData;
+    private normalizePieData;
+    private normalizeWaterfallData;
+    /**
+     * Calculate Y-axis width based on max label width (Doc 1, Section 5).
+     */
+    private calculateAxisWidth;
+    /**
+     * Format axis value for display.
+     */
+    private formatAxisValue;
+    /**
+     * Sub-pixel grid snapping (Doc 3, Section 5).
+     */
+    private snap;
+    /**
+     * Create arc path for pie charts.
+     */
+    private createArcPath;
+    /**
+     * Generate patterns for the palette.
+     */
+    private generatePatterns;
+    /**
+     * Derive seed from data hash.
+     */
+    private deriveSeed;
+    /**
+     * Count nodes in scene graph.
+     */
+    private countNodes;
+    /**
+     * Reset stats for new compilation.
+     */
+    private resetStats;
+    /**
+     * Create minimal accessibility metadata.
+     */
+    private createMinimalAccessibility;
+    /**
+     * Create minimal XMP metadata.
+     */
+    private createMinimalXMP;
+}
+/** Default compiler instance */
+export declare const pvceCompiler: PVCECompiler;
+/**
+ * Compile a chart with default options.
+ */
+export declare function compileChart<T>(chartType: ChartType, input: ChartInput<T>, options?: CompilerOptions): CompilationResult;
+/**
+ * Quick compile to SVG string only.
+ */
+export declare function chartToSVG<T>(chartType: ChartType, data: T, options?: CompilerOptions): string;
+//# sourceMappingURL=compiler.d.ts.map

package/dist-pro/types/pvce/src/charts/compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../../../../../../pvce/src/charts/compiler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EACL,UAAU,EACV,SAAS,EAGT,iBAAiB,EAUlB,MAAM,YAAY,CAAC;AA6BpB,uBAAuB;AACvB,MAAM,WAAW,eAAe;IAC9B,uBAAuB;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wBAAwB;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,6BAA6B;IAC7B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+BAA+B;IAC/B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,2BAA2B;IAC3B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAoBD;;;;;;;;GAQG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,eAAe,CAAsB;IAC7C,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,sBAAsB,CAAyB;IACvD,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,OAAO,CAA4B;IAG3C,OAAO,CAAC,KAAK,CAOX;gBAEU,OAAO,GAAE,eAAoB;IAoBzC;;;OAGG;IACH,OAAO,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,iBAAiB;IAqHzE;;OAEG;IACH,OAAO,CAAC,eAAe;IAwGvB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA4GxB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA4I3B;;OAEG;IACH,OAAO,CAAC,eAAe;IAkJvB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAoK7B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAqCzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAwCzB;;OAEG;IACH,OAAO,CAAC,eAAe;IAyCvB,OAAO,CAAC,gBAAgB;IAqBxB,OAAO,CAAC,iBAAiB;IAwCzB,OAAO,CAAC,oBAAoB;IAkB5B,OAAO,CAAC,gBAAgB;IAiBxB,OAAO,CAAC,sBAAsB;IAgB9B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;OAEG;IACH,OAAO,CAAC,eAAe;IAQvB;;OAEG;IACH,OAAO,CAAC,IAAI;IAIZ;;OAEG;IACH,OAAO,CAAC,aAAa;IA6BrB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAQxB;;OAEG;IACH,OAAO,CAAC,UAAU;IAIlB;;OAEG;IACH,OAAO,CAAC,UAAU;IAUlB;;OAEG;IACH,OAAO,CAAC,UAAU;IAWlB;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAWlC;;OAEG;IACH,OAAO,CAAC,gBAAgB;CASzB;AAMD,gCAAgC;AAChC,eAAO,MAAM,YAAY,cAAqB,CAAC;AAE/C;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,EACpB,OAAO,CAAC,EAAE,eAAe,GACxB,iBAAiB,CAGnB;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAC1B,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,CAAC,EACP,OAAO,CAAC,EAAE,eAAe,GACxB,MAAM,CAcR"}

package/dist-pro/types/pvce/src/charts/determinism.d.ts

@@ -0,0 +1,104 @@
+/**
+ * PVCE Determinism Engine
+ * =======================
+ * Document 1, Section 4: Absolute Determinism - The "Time = 0" Mandate
+ *
+ * Features:
+ * - Seedable PRNG (Pseudo-Random Number Generator)
+ * - Data hashing for VRT (Visual Regression Testing)
+ * - Zero-animation policy enforcement
+ * - Deterministic ID generation
+ */
+import type { SeededRandom, SceneGraph, SceneNode } from "./types.js";
+/**
+ * Mulberry32 - A fast, high-quality 32-bit PRNG.
+ * Produces deterministic sequences from a given seed.
+ *
+ * Used for:
+ * - Jitter plots (Doc 1, Section 4: Math.random() Ban)
+ * - Consistent scatter point positioning
+ * - Reproducible "random" visual elements
+ */
+export declare class Mulberry32 implements SeededRandom {
+    private state;
+    readonly seed: number;
+    constructor(seed: number);
+    /**
+     * Get next random number in range [0, 1).
+     */
+    next(): number;
+    /**
+     * Get random integer in range [min, max] (inclusive).
+     */
+    nextInt(min: number, max: number): number;
+    /**
+     * Get random item from array.
+     */
+    choice<T>(array: T[]): T;
+    /**
+     * Shuffle array using Fisher-Yates algorithm.
+     * Returns a new array (does not mutate input).
+     */
+    shuffle<T>(array: T[]): T[];
+    /**
+     * Reset to initial seed state.
+     */
+    reset(): void;
+}
+/**
+ * Generate a deterministic hash from chart data.
+ * Used for VRT verification (Doc 1, Section 3: metadata.dataHash).
+ */
+export declare function hashData(data: unknown): string;
+/**
+ * Generate a short hash (first 8 chars) for display/IDs.
+ */
+export declare function shortHash(data: unknown): string;
+/**
+ * Generate a deterministic ID from data index.
+ * Doc 1, Section 3: "Deterministic ID generated from data index"
+ */
+export declare function generateNodeId(prefix: string, dataIndex: number, parentId?: string): string;
+/**
+ * Generate IDs for an array of items.
+ */
+export declare function generateNodeIds(prefix: string, count: number, parentId?: string): string[];
+/**
+ * Strip all animation-related attributes from scene nodes.
+ * Doc 1, Section 4: "All animations are stripped at the compiler level."
+ */
+export declare function stripAnimations(node: SceneNode): SceneNode;
+/**
+ * Verify a scene graph has no animations.
+ */
+export declare function verifyNoAnimations(graph: SceneGraph): {
+    valid: boolean;
+    violations: string[];
+};
+/**
+ * Validate scene graph for determinism requirements.
+ */
+export declare function validateDeterminism(graph: SceneGraph): {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+};
+/**
+ * Compare two scene graphs for equality.
+ * Used for "Same Data, Same ID" test (Doc 1, Section 6).
+ */
+export declare function compareSceneGraphs(graph1: SceneGraph, graph2: SceneGraph): {
+    equal: boolean;
+    differences: string[];
+};
+/**
+ * Derive a seed from data for reproducible "random" elements.
+ * Doc 1, Section 4: "Seed is derived from the data hash"
+ */
+export declare function deriveSeedFromData(data: unknown): number;
+/**
+ * Create a seeded random generator from chart data.
+ */
+export declare function createSeededRandom(data: unknown): SeededRandom;
+export { SeededRandom };
+//# sourceMappingURL=determinism.d.ts.map

package/dist-pro/types/pvce/src/charts/determinism.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"determinism.d.ts","sourceRoot":"","sources":["../../../../../../pvce/src/charts/determinism.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAOtE;;;;;;;;GAQG;AACH,qBAAa,UAAW,YAAW,YAAY;IAC7C,OAAO,CAAC,KAAK,CAAS;IACtB,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAEjB,IAAI,EAAE,MAAM;IAKxB;;OAEG;IACH,IAAI,IAAI,MAAM;IAOd;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;IAIzC;;OAEG;IACH,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC;IAIxB;;;OAGG;IACH,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE;IAS3B;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd;AAMD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAG9C;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAE/C;AA6BD;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAGR;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,EAAE,CAIV;AAMD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CA0B1D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG;IACrD,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB,CAuBA;AAMD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG;IACtD,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAyCA;AAMD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,UAAU,GACjB;IACD,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB,CA8DA;AAMD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAIxD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,YAAY,CAG9D;AAMD,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist-pro/types/pvce/src/charts/glyph-oracle.d.ts

@@ -0,0 +1,113 @@
+/**
+ * PVCE Glyph Oracle - Text Measurement Engine
+ * ============================================
+ * Document 2, Section 2: The Text Measurement Oracle
+ *
+ * Provides deterministic text measurement without DOM dependency.
+ * Uses pre-calculated glyph metrics with caching for performance.
+ */
+import { GlyphMetrics, TextBox, LBU, Point } from "./types.js";
+/**
+ * GlyphOracle - Deterministic text measurement engine
+ *
+ * Features (Doc 2 compliance):
+ * - Pre-calculated glyph metrics (no DOM dependency)
+ * - Session-based caching for performance (Doc 2, Section 7)
+ * - Sub-pixel precision for accurate layout
+ * - Multi-font support with fallback
+ */
+export declare class GlyphOracle {
+    private cache;
+    private readonly maxCacheSize;
+    private cacheHits;
+    private cacheMisses;
+    constructor(options?: {
+        maxCacheSize?: number;
+    });
+    /**
+     * Measure text dimensions deterministically.
+     * Doc 2, Section 2: "Exact bounding box of every string"
+     */
+    measureText(text: string, fontSize: number, fontFamily?: string): GlyphMetrics;
+    /**
+     * Get raw font metrics for a font family.
+     * Used by E-BBox calculator for glyph envelope calculations.
+     */
+    getFontMetrics(fontFamily: string): {
+        avgCharWidth: number;
+        capHeight: number;
+        xHeight: number;
+        ascent: number;
+        descent: number;
+        lineHeight: number;
+    };
+    /**
+     * Create a TextBox with full positioning information.
+     * Doc 2, Section 2: TextBox interface
+     */
+    createTextBox(text: string, fontSize: number, options?: {
+        fontFamily?: string;
+        anchor?: "start" | "middle" | "end";
+        rotation?: number;
+        padding?: number;
+    }): TextBox;
+    /**
+     * Calculate the maximum label width for a set of labels.
+     * Used for "Fixed Gutter Strategy" (Doc 1, Section 5).
+     */
+    getMaxLabelWidth(labels: string[], fontSize: number, fontFamily?: string): number;
+    /**
+     * Get bounding box for rotated text.
+     * Used for 45° and 90° label rotation (Doc 2, Section 3).
+     */
+    getRotatedBounds(textBox: TextBox): {
+        width: LBU;
+        height: LBU;
+    };
+    /**
+     * Check if two text boxes overlap.
+     * Used for collision detection (Doc 2, Section 3).
+     */
+    boxesOverlap(box1: TextBox, pos1: Point, box2: TextBox, pos2: Point): boolean;
+    /**
+     * Format number for display (e.g., currency, percentage).
+     * Pre-measures result for consistent layout.
+     */
+    formatAndMeasure(value: number, format: "number" | "currency" | "percent" | "compact", fontSize: number, fontFamily?: string, options?: {
+        currency?: string;
+        decimals?: number;
+        locale?: string;
+    }): {
+        text: string;
+        metrics: GlyphMetrics;
+    };
+    /**
+     * Get cache statistics.
+     */
+    getStats(): {
+        cacheSize: number;
+        cacheHits: number;
+        cacheMisses: number;
+        hitRate: number;
+    };
+    /**
+     * Clear the glyph cache.
+     */
+    clearCache(): void;
+    private getCacheKey;
+    private addToCache;
+    private evictOldestEntry;
+    private getAnchoredX;
+    private compactNumber;
+}
+/** Global GlyphOracle instance for shared caching */
+export declare const glyphOracle: GlyphOracle;
+/**
+ * Measure text using the global oracle.
+ */
+export declare function measureText(text: string, fontSize: number, fontFamily?: string): GlyphMetrics;
+/**
+ * Get max width of labels.
+ */
+export declare function getMaxLabelWidth(labels: string[], fontSize: number, fontFamily?: string): number;
+//# sourceMappingURL=glyph-oracle.d.ts.map

package/dist-pro/types/pvce/src/charts/glyph-oracle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glyph-oracle.d.ts","sourceRoot":"","sources":["../../../../../../pvce/src/charts/glyph-oracle.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAmB,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAuahF;;;;;;;;GAQG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAA2C;IACxD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,WAAW,CAAK;gBAEZ,OAAO,GAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAA;KAAO;IAInD;;;OAGG;IACH,WAAW,CACT,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,UAAU,GAAE,MAAgB,GAC3B,YAAY;IA4Cf;;;OAGG;IACH,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG;QAClC,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;KACpB;IAYD;;;OAGG;IACH,aAAa,CACX,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;QACP,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;KACb,GACL,OAAO;IAqBV;;;OAGG;IACH,gBAAgB,CACd,MAAM,EAAE,MAAM,EAAE,EAChB,QAAQ,EAAE,MAAM,EAChB,UAAU,GAAE,MAAgB,GAC3B,MAAM;IAST;;;OAGG;IACH,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG;QAAE,KAAK,EAAE,GAAG,CAAC;QAAC,MAAM,EAAE,GAAG,CAAA;KAAE;IAW/D;;;OAGG;IACH,YAAY,CACV,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,KAAK,EACX,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,KAAK,GACV,OAAO;IAkBV;;;OAGG;IACH,gBAAgB,CACd,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,EACrD,QAAQ,EAAE,MAAM,EAChB,UAAU,GAAE,MAAgB,EAC5B,OAAO,GAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO,GACtE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,YAAY,CAAA;KAAE;IAoC1C;;OAEG;IACH,QAAQ,IAAI;QACV,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;KACjB;IAUD;;OAEG;IACH,UAAU,IAAI,IAAI;IAUlB,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,UAAU;IAalB,OAAO,CAAC,gBAAgB;IAgBxB,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,aAAa;CAQtB;AAMD,qDAAqD;AACrD,eAAO,MAAM,WAAW,aAAoB,CAAC;AAM7C;;GAEG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,GAClB,YAAY,CAEd;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EAAE,EAChB,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CAER"}

package/dist-pro/types/pvce/src/charts/index.d.ts

@@ -0,0 +1,46 @@
+/**
+ * PVCE (Precision-Vector Charting Engine) - Main Entry Point
+ * ==========================================================
+ *
+ * Production-ready charting engine implementing:
+ * - Doc 1: Deterministic Scene Graph & Compiler Architecture
+ * - Doc 2: Typographic Precision & Label Collision Logic
+ * - Doc 3: Sub-Pixel Vector Normalization & Scaling
+ * - Doc 4: Print-Specific Color & Accessible Data Structures
+ *
+ * @example
+ * ```typescript
+ * import { compileChart, chartToSVG } from './pvce';
+ *
+ * // Quick SVG generation
+ * const svg = chartToSVG('bar', [10, 20, 30, 40]);
+ *
+ * // Full compilation with metadata
+ * const result = compileChart('line', {
+ *   data: { categories: ['Q1', 'Q2', 'Q3'], values: [100, 150, 200] },
+ *   encoding: {},
+ *   constraints: { width: 800, height: 600 }
+ * });
+ *
+ * console.log(result.svg);
+ * console.log(result.accessibility.altText);
+ * ```
+ */
+export type { SceneGraph, SceneNode, SceneNodeType, SceneAttributes, SceneGraphMetadata, NodeMetadata, LBU, Point, Rect, TextBox, GlyphMetrics, GlyphCacheEntry, LabelPlacement, LeaderLine, RGBColor, CMYKColor, GrayscaleValue, UnifiedColor, ColorPalette, PatternDefinition, PatternType, ColorMode, AccessibilityMetadata, DataPointAccessibility, XMPMetadata, ChartType, ChartInput, ChartEncoding, ChartConstraints, ChartConfig, CompilationResult, CompilationStats, ValidationResult, ValidationError, ValidationWarning, SeededRandom, OptimizedPath, PathSimplificationOptions, } from "./types.js";
+export { CollisionLevel } from "./types.js";
+export { VIRTUAL_CANVAS, HAIRLINE_MIN_PT, SNAP_THRESHOLD } from "./types.js";
+import { PVCECompiler as _PVCECompiler, pvceCompiler as _pvceCompiler, compileChart as _compileChart, chartToSVG as _chartToSVG } from "./compiler.js";
+export { _PVCECompiler as PVCECompiler, _pvceCompiler as pvceCompiler };
+export { _compileChart as compileChart, _chartToSVG as chartToSVG };
+export type { CompilerOptions } from "./compiler.js";
+export { GlyphOracle, glyphOracle, measureText, getMaxLabelWidth, } from "./glyph-oracle.js";
+export { AxisCollisionSolver, collisionSolver, resolveAxisLabels, resolvePointLabels, } from "./collision-solver.js";
+export type { CollisionConfig } from "./collision-solver.js";
+export { SVGRenderer, svgRenderer, renderToSVG, snapToGrid, ensureMinStroke, } from "./svg-renderer.js";
+export type { SVGRenderOptions } from "./svg-renderer.js";
+export { ColorPipeline, colorPipeline, parseColor, getContrastRatio, meetsContrastRequirement, createMonochromePalette, WCAG_CONTRAST, MIN_GRAY_DIFFERENCE, DEFAULT_PALETTE_COLORS, COLORBLIND_SAFE_COLORS, } from "./color-pipeline.js";
+export { AccessibilityGenerator, accessibilityGenerator, generateChartAltText, generateXMPMetadata, hashChartData, } from "./accessibility.js";
+export type { AccessibilityOptions, ChartData } from "./accessibility.js";
+export { Mulberry32, hashData, shortHash, generateNodeId, generateNodeIds, stripAnimations, verifyNoAnimations, validateDeterminism, compareSceneGraphs, deriveSeedFromData, createSeededRandom, } from "./determinism.js";
+export { PathOptimizer, pathOptimizer, simplifyPath, simplifyPathString, optimizeLineChart, } from "./path-optimizer.js";
+//# sourceMappingURL=index.d.ts.map

package/dist-pro/types/pvce/src/charts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../pvce/src/charts/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAGH,YAAY,EAEV,UAAU,EACV,SAAS,EACT,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,YAAY,EAGZ,GAAG,EACH,KAAK,EACL,IAAI,EAGJ,OAAO,EACP,YAAY,EACZ,eAAe,EACf,cAAc,EACd,UAAU,EAGV,QAAQ,EACR,SAAS,EACT,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,SAAS,EAGT,qBAAqB,EACrB,sBAAsB,EACtB,WAAW,EAGX,SAAS,EACT,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,WAAW,EAGX,iBAAiB,EACjB,gBAAgB,EAGhB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EAGjB,YAAY,EAGZ,aAAa,EACb,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG5C,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG7E,OAAO,EACL,YAAY,IAAI,aAAa,EAC7B,YAAY,IAAI,aAAa,EAC7B,YAAY,IAAI,aAAa,EAC7B,UAAU,IAAI,WAAW,EAC1B,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,aAAa,IAAI,YAAY,EAAE,aAAa,IAAI,YAAY,EAAE,CAAC;AAExE,OAAO,EAAE,aAAa,IAAI,YAAY,EAAE,WAAW,IAAI,UAAU,EAAE,CAAC;AAEpE,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGrD,OAAO,EACL,WAAW,EACX,WAAW,EACX,WAAW,EACX,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAG7D,OAAO,EACL,WAAW,EACX,WAAW,EACX,WAAW,EACX,UAAU,EACV,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAG1D,OAAO,EACL,aAAa,EACb,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,wBAAwB,EACxB,uBAAuB,EACvB,aAAa,EACb,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,aAAa,GACd,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAG1E,OAAO,EACL,UAAU,EACV,QAAQ,EACR,SAAS,EACT,cAAc,EACd,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,aAAa,EACb,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC"}