ppef 1.0.0 → 1.0.1

package/dist/__tests__/test-helpers.js

@@ -0,0 +1,271 @@
+/**
+ * Test Helpers for Framework Tests
+ *
+ * Factory functions for creating mock evaluation results, aggregates,
+ * and claims for testing the evaluation framework.
+ */
+/**
+ * Create a mock EvaluationResult with sensible defaults.
+ *
+ * @param overrides - Partial fields to override defaults
+ * @returns A complete EvaluationResult
+ */
+export const createMockResult = (overrides) => {
+    const defaultRun = {
+        runId: "mock-run-001",
+        sut: "test-sut-v1.0.0",
+        sutRole: "primary",
+        caseId: "test-case-001",
+        caseClass: "test-class",
+    };
+    const defaultCorrectness = {
+        expectedExists: true,
+        producedOutput: true,
+        valid: true,
+        matchesExpected: true,
+    };
+    const defaultOutputs = {
+        summary: {},
+    };
+    const defaultMetrics = {
+        numeric: {
+            "execution-time": 100,
+            "nodes-expanded": 50,
+            "path-diversity": 0.75,
+        },
+    };
+    const defaultProvenance = {
+        runtime: {
+            platform: "darwin",
+            arch: "arm64",
+            nodeVersion: "20.0.0",
+        },
+        timestamp: new Date().toISOString(),
+    };
+    return {
+        run: { ...defaultRun, ...overrides?.run },
+        correctness: { ...defaultCorrectness, ...overrides?.correctness },
+        outputs: { ...defaultOutputs, ...overrides?.outputs },
+        metrics: { ...defaultMetrics, ...overrides?.metrics },
+        provenance: { ...defaultProvenance, ...overrides?.provenance },
+    };
+};
+/**
+ * Create multiple mock results for a specific SUT.
+ *
+ * @param count - Number of results to create
+ * @param sut - SUT identifier
+ * @param role - SUT role (default: "primary")
+ * @param caseClass - Optional case class
+ * @returns Array of EvaluationResults
+ */
+export const createMockResults = (count, sut, role = "primary", caseClass) => Array.from({ length: count }, (_, index) => createMockResult({
+    run: {
+        runId: `${sut}-run-${index.toString().padStart(3, "0")}`,
+        sut,
+        sutRole: role,
+        caseId: `case-${index.toString().padStart(3, "0")}`,
+        caseClass,
+    },
+    metrics: {
+        numeric: {
+            "execution-time": 100 + Math.random() * 50,
+            "nodes-expanded": 50 + Math.floor(Math.random() * 20),
+            "path-diversity": 0.5 + Math.random() * 0.4,
+        },
+    },
+}));
+/**
+ * Create mock SummaryStats.
+ *
+ * @param values - Array of values to compute stats from
+ * @returns SummaryStats
+ */
+export const createMockSummaryStats = (values) => {
+    if (values.length === 0) {
+        return {
+            n: 0,
+            mean: Number.NaN,
+            median: Number.NaN,
+            min: Number.NaN,
+            max: Number.NaN,
+        };
+    }
+    const sorted = [...values].sort((a, b) => a - b);
+    const n = values.length;
+    const sum = values.reduce((accumulator, v) => accumulator + v, 0);
+    const mean = sum / n;
+    const midIndex = Math.floor(n / 2);
+    const median = n % 2 === 0 ? (sorted[midIndex - 1] + sorted[midIndex]) / 2 : sorted[midIndex];
+    let std;
+    if (n > 1) {
+        const variance = values.map((v) => (v - mean) ** 2).reduce((accumulator, v) => accumulator + v, 0) / (n - 1);
+        std = Math.sqrt(variance);
+    }
+    return {
+        n,
+        mean,
+        median,
+        min: sorted[0],
+        max: sorted[n - 1],
+        std,
+        sum,
+    };
+};
+/**
+ * Create mock AggregatedResult.
+ *
+ * @param sut - SUT identifier
+ * @param role - SUT role
+ * @param caseClass - Optional case class
+ * @param metrics - Optional metrics map
+ * @returns AggregatedResult
+ */
+export const createMockAggregate = (sut, role = "primary", caseClass, metrics) => {
+    const defaultMetrics = {
+        "execution-time": createMockSummaryStats([100, 110, 105, 115, 120]),
+        "nodes-expanded": createMockSummaryStats([50, 55, 52, 58, 60]),
+        "path-diversity": createMockSummaryStats([0.7, 0.75, 0.72, 0.78, 0.8]),
+    };
+    return {
+        sut,
+        sutRole: role,
+        caseClass,
+        group: {
+            runCount: 5,
+            caseCount: 5,
+        },
+        correctness: {
+            validRate: 1,
+            producedOutputRate: 1,
+            matchesExpectedRate: 1,
+        },
+        metrics: metrics ?? defaultMetrics,
+    };
+};
+/**
+ * Create mock aggregates for testing comparisons.
+ *
+ * @returns Array with primary and baseline aggregates
+ */
+export const createMockAggregates = () => [
+    createMockAggregate("degree-prioritised-v1.0.0", "primary", "scale-free", {
+        "execution-time": createMockSummaryStats([80, 85, 82, 88, 90]),
+        "nodes-expanded": createMockSummaryStats([40, 45, 42, 48, 50]),
+    }),
+    createMockAggregate("standard-bfs-v1.0.0", "baseline", "scale-free", {
+        "execution-time": createMockSummaryStats([120, 125, 122, 128, 130]),
+        "nodes-expanded": createMockSummaryStats([70, 75, 72, 78, 80]),
+    }),
+    createMockAggregate("frontier-balanced-v1.0.0", "baseline", "scale-free", {
+        "execution-time": createMockSummaryStats([100, 105, 102, 108, 110]),
+        "nodes-expanded": createMockSummaryStats([60, 65, 62, 68, 70]),
+    }),
+];
+/**
+ * Create a mock EvaluationClaim.
+ *
+ * @param overrides - Partial fields to override defaults
+ * @returns EvaluationClaim
+ */
+export const createMockClaim = (overrides) => ({
+    claimId: "C001",
+    description: "Primary SUT is faster than baseline",
+    sut: "degree-prioritised-v1.0.0",
+    baseline: "standard-bfs-v1.0.0",
+    metric: "execution-time",
+    direction: "less",
+    scope: "global",
+    ...overrides,
+});
+/**
+ * Create mock ClaimEvidence.
+ *
+ * @param overrides - Partial fields to override defaults
+ * @returns ClaimEvidence
+ */
+export const createMockEvidence = (overrides) => ({
+    primaryValue: 85,
+    baselineValue: 125,
+    delta: -40,
+    ratio: 0.68,
+    pValue: 0.01,
+    effectSize: 1.5,
+    n: 10,
+    ...overrides,
+});
+/**
+ * Create mock ClaimEvaluation.
+ *
+ * @param status - Claim status
+ * @param claim - Optional claim
+ * @param evidence - Optional evidence
+ * @returns ClaimEvaluation
+ */
+export const createMockClaimEvaluation = (status = "satisfied", claim, evidence) => ({
+    claim: createMockClaim(claim),
+    status,
+    evidence: createMockEvidence(evidence),
+});
+/**
+ * Create an array of mock results with varying metrics.
+ * Useful for testing aggregation and statistics.
+ *
+ * @param executionTimes - Array of execution times
+ * @param sut - SUT identifier
+ * @param role - SUT role
+ * @returns Array of EvaluationResults
+ */
+export const createMockResultsWithMetrics = (executionTimes, sut, role = "primary") => executionTimes.map((time, index) => createMockResult({
+    run: {
+        runId: `${sut}-run-${index.toString().padStart(3, "0")}`,
+        sut,
+        sutRole: role,
+        caseId: `case-${index.toString().padStart(3, "0")}`,
+    },
+    metrics: {
+        numeric: {
+            "execution-time": time,
+        },
+    },
+}));
+/**
+ * Create a minimal valid result for validation tests.
+ * Returns the bare minimum fields required by the schema.
+ */
+export const createMinimalValidResult = () => ({
+    run: {
+        runId: "minimal-001",
+        sut: "test-sut",
+        sutRole: "primary",
+        caseId: "test-case",
+    },
+    correctness: {
+        expectedExists: false,
+        producedOutput: true,
+        valid: true,
+        matchesExpected: null,
+    },
+    outputs: {},
+    metrics: {
+        numeric: {},
+    },
+    provenance: {
+        runtime: {
+            platform: "test",
+            arch: "test",
+            nodeVersion: "20.0.0",
+        },
+    },
+});
+/**
+ * Create an invalid result missing required fields.
+ * Useful for testing validation logic.
+ */
+export const createInvalidResult = () => ({
+    run: {
+    // Missing runId, sut, sutRole, caseId
+    },
+    // Missing correctness, metrics, provenance
+});
+//# sourceMappingURL=test-helpers.js.map

package/dist/__tests__/test-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-helpers.js","sourceRoot":"","sources":["../../src/__tests__/test-helpers.ts"],"names":[],"mappings":"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"}

package/dist/aggregation/aggregators.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Aggregation Functions
+ *
+ * Pure functions for computing aggregated statistics from evaluation results.
+ * These functions are extracted from inline table generation code to ensure
+ * separation of concerns.
+ */
+import type { ComparisonMetrics, SummaryStats } from "../types/aggregate.js";
+import type { EvaluationResult } from "../types/result.js";
+/**
+ * Compute summary statistics for an array of numbers.
+ *
+ * @param values - Array of numeric values
+ * @returns Summary statistics
+ */
+export declare const computeSummaryStats: (values: number[]) => SummaryStats;
+/**
+ * Compute speedup ratio (baseline / treatment).
+ *
+ * @param baselineTime - Baseline execution time
+ * @param treatmentTime - Treatment execution time
+ * @returns Speedup ratio
+ */
+export declare const computeSpeedup: (baselineTime: number, treatmentTime: number) => number;
+/**
+ * Compute maximum speedup from multiple pairs.
+ *
+ * @param pairs - Array of [baseline, treatment] time pairs
+ * @returns Maximum speedup ratio
+ */
+export declare const computeMaxSpeedup: (pairs: [number, number][]) => number;
+/**
+ * Compute comparison metrics between primary and baseline results.
+ *
+ * @param primaryResults - Full result objects from primary SUT
+ * @param baselineResults - Full result objects from baseline SUT
+ * @param metricName - Metric to compare
+ * @returns Comparison metrics
+ */
+export declare const computeComparison: (primaryResults: EvaluationResult[], baselineResults: EvaluationResult[], metricName: string) => ComparisonMetrics;
+/**
+ * Compute rankings from results.
+ *
+ * @param results - Results to rank
+ * @param metricName - Metric to rank by
+ * @param ascending - Sort ascending (lower is better)
+ * @returns Ranked results with positions
+ */
+export declare const computeRankings: (results: EvaluationResult[], metricName: string, ascending?: boolean) => {
+    result: EvaluationResult;
+    rank: number;
+    value: number;
+}[];
+//# sourceMappingURL=aggregators.d.ts.map

package/dist/aggregation/aggregators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregators.d.ts","sourceRoot":"","sources":["../../src/aggregation/aggregators.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,QAAQ,MAAM,EAAE,KAAG,YAuDtD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GAAI,cAAc,MAAM,EAAE,eAAe,MAAM,KAAG,MAG5E,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,KAAG,MAG7D,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,GAC7B,gBAAgB,gBAAgB,EAAE,EAClC,iBAAiB,gBAAgB,EAAE,EACnC,YAAY,MAAM,KAChB,iBA+EF,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAC3B,SAAS,gBAAgB,EAAE,EAC3B,YAAY,MAAM,EAClB,mBAAiB,KACf;IAAE,MAAM,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAgB3D,CAAC"}

package/dist/aggregation/aggregators.js

@@ -0,0 +1,228 @@
+/**
+ * Aggregation Functions
+ *
+ * Pure functions for computing aggregated statistics from evaluation results.
+ * These functions are extracted from inline table generation code to ensure
+ * separation of concerns.
+ */
+import { mannWhitneyUTest } from "../statistical/mann-whitney-u.js";
+/**
+ * Compute summary statistics for an array of numbers.
+ *
+ * @param values - Array of numeric values
+ * @returns Summary statistics
+ */
+export const computeSummaryStats = (values) => {
+    if (values.length === 0) {
+        return {
+            n: 0,
+            mean: Number.NaN,
+            median: Number.NaN,
+            min: Number.NaN,
+            max: Number.NaN,
+        };
+    }
+    const n = values.length;
+    const sorted = [...values].sort((a, b) => a - b);
+    const sum = values.reduce((accumulator, v) => accumulator + v, 0);
+    const mean = sum / n;
+    const min = sorted[0];
+    const max = sorted[n - 1];
+    // Median
+    const midIndex = Math.floor(n / 2);
+    const median = n % 2 === 0 ? (sorted[midIndex - 1] + sorted[midIndex]) / 2 : sorted[midIndex];
+    // Standard deviation (sample)
+    let std;
+    if (n > 1) {
+        const squaredDiffs = values.map((v) => (v - mean) ** 2);
+        const variance = squaredDiffs.reduce((accumulator, v) => accumulator + v, 0) / (n - 1);
+        std = Math.sqrt(variance);
+    }
+    // 95% confidence interval (assumes normal distribution)
+    let confidence95;
+    if (std !== undefined && n > 1) {
+        const standardError = std / Math.sqrt(n);
+        const tValue = getTValue(n - 1, 0.975); // Two-tailed 95% CI
+        const margin = tValue * standardError;
+        confidence95 = [mean - margin, mean + margin];
+    }
+    // Percentiles
+    const p25 = sorted[Math.floor(n * 0.25)];
+    const p75 = sorted[Math.floor(n * 0.75)];
+    return {
+        n,
+        mean,
+        median,
+        min,
+        max,
+        std,
+        confidence95,
+        sum,
+        p25,
+        p75,
+    };
+};
+/**
+ * Compute speedup ratio (baseline / treatment).
+ *
+ * @param baselineTime - Baseline execution time
+ * @param treatmentTime - Treatment execution time
+ * @returns Speedup ratio
+ */
+export const computeSpeedup = (baselineTime, treatmentTime) => {
+    if (treatmentTime === 0)
+        return Infinity;
+    return baselineTime / treatmentTime;
+};
+/**
+ * Compute maximum speedup from multiple pairs.
+ *
+ * @param pairs - Array of [baseline, treatment] time pairs
+ * @returns Maximum speedup ratio
+ */
+export const computeMaxSpeedup = (pairs) => {
+    if (pairs.length === 0)
+        return 0;
+    return Math.max(...pairs.map(([b, t]) => computeSpeedup(b, t)));
+};
+/**
+ * Compute comparison metrics between primary and baseline results.
+ *
+ * @param primaryResults - Full result objects from primary SUT
+ * @param baselineResults - Full result objects from baseline SUT
+ * @param metricName - Metric to compare
+ * @returns Comparison metrics
+ */
+export const computeComparison = (primaryResults, baselineResults, metricName) => {
+    // Extract values and match by case ID
+    const primaryByCase = new Map();
+    const baselineByCase = new Map();
+    for (const result of primaryResults) {
+        const value = result.metrics.numeric[metricName];
+        primaryByCase.set(result.run.caseId, value);
+    }
+    for (const result of baselineResults) {
+        const value = result.metrics.numeric[metricName];
+        baselineByCase.set(result.run.caseId, value);
+    }
+    // Get matching case IDs
+    const commonCaseIds = [...primaryByCase.keys()].filter((id) => baselineByCase.has(id));
+    if (commonCaseIds.length === 0) {
+        return {
+            deltas: { default: 0 },
+            ratios: { default: 1 },
+        };
+    }
+    // Extract paired values
+    const primaryValues = [];
+    const baselineValues = [];
+    for (const caseId of commonCaseIds) {
+        const primaryValue = primaryByCase.get(caseId);
+        const baselineValue = baselineByCase.get(caseId);
+        if (primaryValue !== undefined && baselineValue !== undefined) {
+            primaryValues.push(primaryValue);
+            baselineValues.push(baselineValue);
+        }
+    }
+    const primaryStats = computeSummaryStats(primaryValues);
+    const baselineStats = computeSummaryStats(baselineValues);
+    const delta = primaryStats.mean - baselineStats.mean;
+    const ratio = baselineStats.mean === 0 ? Infinity : primaryStats.mean / baselineStats.mean;
+    // Win rate: percentage of cases where primary > baseline (paired by case ID)
+    let wins = 0;
+    for (const [index, primaryValue] of primaryValues.entries()) {
+        if (primaryValue > baselineValues[index]) {
+            wins++;
+        }
+    }
+    const betterRate = wins / primaryValues.length;
+    // Mann-Whitney U test for statistical significance
+    const mwuResult = mannWhitneyUTest(primaryValues, baselineValues);
+    // Effect size (Cohen's d)
+    let effectSize;
+    if (primaryStats.std !== undefined &&
+        baselineStats.std !== undefined &&
+        primaryStats.n > 1 &&
+        baselineStats.n > 1) {
+        const pooledStd = Math.sqrt(((primaryStats.n - 1) * primaryStats.std ** 2 +
+            (baselineStats.n - 1) * baselineStats.std ** 2) /
+            (primaryStats.n + baselineStats.n - 2));
+        effectSize = pooledStd === 0 ? 0 : Math.abs(delta) / pooledStd;
+    }
+    return {
+        deltas: { default: delta },
+        ratios: { default: ratio },
+        betterRate,
+        uStatistic: mwuResult.u,
+        pValue: mwuResult.pValue,
+        effectSize,
+    };
+};
+/**
+ * Compute rankings from results.
+ *
+ * @param results - Results to rank
+ * @param metricName - Metric to rank by
+ * @param ascending - Sort ascending (lower is better)
+ * @returns Ranked results with positions
+ */
+export const computeRankings = (results, metricName, ascending = false) => {
+    const withValues = results
+        .map((result) => ({
+        result,
+        value: result.metrics.numeric[metricName] ?? Number.NaN,
+    }))
+        .filter(({ value }) => !Number.isNaN(value));
+    // Sort
+    withValues.sort((a, b) => (ascending ? a.value - b.value : b.value - a.value));
+    // Assign ranks
+    return withValues.map((item, index) => ({
+        ...item,
+        rank: index + 1,
+    }));
+};
+/**
+ * Get t-value for confidence interval calculation.
+ * This is a simplified lookup table for common degrees of freedom.
+ *
+ * @param df - Degrees of freedom
+ * @param probability - Probability (e.g., 0.975 for 95% two-tailed)
+ * @returns t-value
+ */
+const getTValue = (df, probability) => {
+    // Simplified t-table for 95% CI (probability = 0.975)
+    if (probability !== 0.975) {
+        return 1.96; // Fall back to z-value for large samples
+    }
+    const tTable = {
+        1: 12.706,
+        2: 4.303,
+        3: 3.182,
+        4: 2.776,
+        5: 2.571,
+        6: 2.447,
+        7: 2.365,
+        8: 2.306,
+        9: 2.262,
+        10: 2.228,
+        15: 2.131,
+        20: 2.086,
+        25: 2.06,
+        30: 2.042,
+        40: 2.021,
+        50: 2.009,
+        100: 1.984,
+    };
+    // Find closest df
+    const dfs = Object.keys(tTable)
+        .map(Number)
+        .sort((a, b) => a - b);
+    for (const key of dfs) {
+        if (df <= key) {
+            return tTable[key];
+        }
+    }
+    // Large sample: use z-value
+    return 1.96;
+};
+//# sourceMappingURL=aggregators.js.map

package/dist/aggregation/aggregators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregators.js","sourceRoot":"","sources":["../../src/aggregation/aggregators.ts"],"names":[],"mappings":"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"}

package/dist/aggregation/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Aggregation Module
+ *
+ * Re-exports aggregation functions and pipeline.
+ */
+export { computeComparison, computeMaxSpeedup, computeRankings, computeSpeedup, computeSummaryStats, } from "./aggregators.js";
+export { aggregateResults, type AggregationPipelineOptions, createAggregationOutput, } from "./pipeline.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/aggregation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/aggregation/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACN,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,mBAAmB,GACnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACN,gBAAgB,EAChB,KAAK,0BAA0B,EAC/B,uBAAuB,GACvB,MAAM,eAAe,CAAC"}

package/dist/aggregation/index.js

@@ -0,0 +1,8 @@
+/**
+ * Aggregation Module
+ *
+ * Re-exports aggregation functions and pipeline.
+ */
+export { computeComparison, computeMaxSpeedup, computeRankings, computeSpeedup, computeSummaryStats, } from "./aggregators.js";
+export { aggregateResults, createAggregationOutput, } from "./pipeline.js";
+//# sourceMappingURL=index.js.map

package/dist/aggregation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/aggregation/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACN,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,mBAAmB,GACnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACN,gBAAgB,EAEhB,uBAAuB,GACvB,MAAM,eAAe,CAAC"}

package/dist/aggregation/pipeline.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Aggregation Pipeline
+ *
+ * Transforms raw evaluation results into aggregated summaries.
+ * This is the core of the Execute -> Aggregate -> Render pipeline.
+ */
+import type { AggregatedResult, AggregationOutput } from "../types/aggregate.js";
+import type { EvaluationResult } from "../types/result.js";
+/**
+ * Options for the aggregation pipeline.
+ */
+export interface AggregationPipelineOptions {
+    /** Group by case class (default: true) */
+    groupByCaseClass?: boolean;
+    /** Compute comparisons with baselines (default: true) */
+    computeComparisons?: boolean;
+    /** Primary SUT ID for comparison (auto-detected if not specified) */
+    primarySut?: string;
+    /** Baseline SUT IDs for comparison (auto-detected if not specified) */
+    baselineSuts?: string[];
+    /** Metrics to aggregate (all if not specified) */
+    metrics?: string[];
+}
+/**
+ * Aggregate evaluation results into summaries.
+ *
+ * @param results - Raw evaluation results
+ * @param options - Aggregation options
+ * @returns Aggregated results
+ */
+export declare const aggregateResults: (results: EvaluationResult[], options?: AggregationPipelineOptions) => AggregatedResult[];
+/**
+ * Create a full aggregation output document.
+ * @param aggregates
+ * @param results
+ */
+export declare const createAggregationOutput: (aggregates: AggregatedResult[], results: EvaluationResult[]) => AggregationOutput;
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/aggregation/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/aggregation/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACX,gBAAgB,EAChB,iBAAiB,EAGjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAG3D;;GAEG;AACH,MAAM,WAAW,0BAA0B;IAC1C,0CAA0C;IAC1C,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B,yDAAyD;IACzD,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,uEAAuE;IACvE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAExB,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAUD;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAC5B,SAAS,gBAAgB,EAAE,EAC3B,UAAS,0BAA+B,KACtC,gBAAgB,EAmBlB,CAAC;AAyLF;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,GACnC,YAAY,gBAAgB,EAAE,EAC9B,SAAS,gBAAgB,EAAE,KACzB,iBAkBF,CAAC"}