@higher.archi/boe 1.0.29 → 1.0.31

package/dist/engines/ranking/index.js

@@ -3,9 +3,14 @@
  * Ranking Engine — Comparative Entity Ranking
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RankingEngine = exports.rankingStrategy = exports.RankingExecutor = exports.compileRankingRuleSet = exports.resolveMovement = exports.resolvePercentileLabel = exports.isKFactorPreset = exports.K_FACTOR_VALUES = void 0;
+exports.RankingEngine = exports.rankingStrategy = exports.RankingExecutor = exports.compileRankingRuleSet = exports.resolveMovement = exports.resolvePercentileLabel = exports.isKFactorPreset = exports.K_FACTOR_VALUES = exports.KFactorPresets = exports.Movements = exports.PercentileLabels = exports.RankingDirections = exports.RankingStrategies = void 0;
 // Constants & utilities
 var types_1 = require("./types");
+Object.defineProperty(exports, "RankingStrategies", { enumerable: true, get: function () { return types_1.RankingStrategies; } });
+Object.defineProperty(exports, "RankingDirections", { enumerable: true, get: function () { return types_1.RankingDirections; } });
+Object.defineProperty(exports, "PercentileLabels", { enumerable: true, get: function () { return types_1.PercentileLabels; } });
+Object.defineProperty(exports, "Movements", { enumerable: true, get: function () { return types_1.Movements; } });
+Object.defineProperty(exports, "KFactorPresets", { enumerable: true, get: function () { return types_1.KFactorPresets; } });
 Object.defineProperty(exports, "K_FACTOR_VALUES", { enumerable: true, get: function () { return types_1.K_FACTOR_VALUES; } });
 Object.defineProperty(exports, "isKFactorPreset", { enumerable: true, get: function () { return types_1.isKFactorPreset; } });
 Object.defineProperty(exports, "resolvePercentileLabel", { enumerable: true, get: function () { return types_1.resolvePercentileLabel; } });

package/dist/engines/ranking/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engines/ranking/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AA4BH,wBAAwB;AACxB,iCAKiB;AAJf,wGAAA,eAAe,OAAA;AACf,wGAAA,eAAe,OAAA;AACf,+GAAA,sBAAsB,OAAA;AACtB,wGAAA,eAAe,OAAA;AAGjB,WAAW;AACX,uCAAmD;AAA1C,iHAAA,qBAAqB,OAAA;AAE9B,WAAW;AACX,uCAA8D;AAArD,2GAAA,eAAe,OAAA;AAAE,2GAAA,eAAe,OAAA;AAEzC,SAAS;AACT,mCAAyC;AAAhC,uGAAA,aAAa,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engines/ranking/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AA4BH,wBAAwB;AACxB,iCAUiB;AATf,0GAAA,iBAAiB,OAAA;AACjB,0GAAA,iBAAiB,OAAA;AACjB,yGAAA,gBAAgB,OAAA;AAChB,kGAAA,SAAS,OAAA;AACT,uGAAA,cAAc,OAAA;AACd,wGAAA,eAAe,OAAA;AACf,wGAAA,eAAe,OAAA;AACf,+GAAA,sBAAsB,OAAA;AACtB,wGAAA,eAAe,OAAA;AAGjB,WAAW;AACX,uCAAmD;AAA1C,iHAAA,qBAAqB,OAAA;AAE9B,WAAW;AACX,uCAA8D;AAArD,2GAAA,eAAe,OAAA;AAAE,2GAAA,eAAe,OAAA;AAEzC,SAAS;AACT,mCAAyC;AAAhC,uGAAA,aAAa,OAAA"}

package/dist/engines/ranking/types.d.ts

@@ -7,15 +7,42 @@
 import type { CompiledScoringRuleSet, ScoringOptions, ScoringTierMatch, TierDefinition } from '../scoring/types';
 import type { SemanticPriority } from '../utility/types';
 /** Ranking algorithm to use */
-export type RankingStrategy = 'score' | 'elo' | 'head-to-head';
+export declare const RankingStrategies: {
+    readonly score: "score";
+    readonly elo: "elo";
+    readonly headToHead: "head-to-head";
+};
+export type RankingStrategy = typeof RankingStrategies[keyof typeof RankingStrategies];
 /** Sort direction for rankings */
-export type RankingDirection = 'highest-first' | 'lowest-first';
+export declare const RankingDirections: {
+    readonly highestFirst: "highest-first";
+    readonly lowestFirst: "lowest-first";
+};
+export type RankingDirection = typeof RankingDirections[keyof typeof RankingDirections];
 /** Human-readable percentile bracket */
-export type PercentileLabel = 'top-1%' | 'top-5%' | 'top-10%' | 'top-25%' | 'top-50%' | 'bottom-half';
+export declare const PercentileLabels: {
+    readonly top1: "top-1%";
+    readonly top5: "top-5%";
+    readonly top10: "top-10%";
+    readonly top25: "top-25%";
+    readonly top50: "top-50%";
+    readonly bottomHalf: "bottom-half";
+};
+export type PercentileLabel = typeof PercentileLabels[keyof typeof PercentileLabels];
 /** Rank movement since previous ranking */
-export type Movement = 'climbed' | 'steady' | 'dropped';
+export declare const Movements: {
+    readonly climbed: "climbed";
+    readonly steady: "steady";
+    readonly dropped: "dropped";
+};
+export type Movement = typeof Movements[keyof typeof Movements];
 /** Elo K-factor presets controlling rating volatility */
-export type KFactorPreset = 'volatile' | 'standard' | 'stable';
+export declare const KFactorPresets: {
+    readonly volatile: "volatile";
+    readonly standard: "standard";
+    readonly stable: "stable";
+};
+export type KFactorPreset = typeof KFactorPresets[keyof typeof KFactorPresets];
 export declare const K_FACTOR_VALUES: Record<KFactorPreset, number>;
 export declare function isKFactorPreset(value: unknown): value is KFactorPreset;
 /** Map a percentile (0-100) to a semantic label */

package/dist/engines/ranking/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/engines/ranking/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/engines/ranking/types.ts"],"names":[],"mappings":"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"}

package/dist/engines/ranking/types.js

@@ -6,10 +6,45 @@
  * Supports score-based ranking, Elo ratings, and head-to-head pairwise comparison.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.K_FACTOR_VALUES = void 0;
+exports.K_FACTOR_VALUES = exports.KFactorPresets = exports.Movements = exports.PercentileLabels = exports.RankingDirections = exports.RankingStrategies = void 0;
 exports.isKFactorPreset = isKFactorPreset;
 exports.resolvePercentileLabel = resolvePercentileLabel;
 exports.resolveMovement = resolveMovement;
+// ========================================
+// Semantic Types
+// ========================================
+/** Ranking algorithm to use */
+exports.RankingStrategies = {
+    score: 'score',
+    elo: 'elo',
+    headToHead: 'head-to-head',
+};
+/** Sort direction for rankings */
+exports.RankingDirections = {
+    highestFirst: 'highest-first',
+    lowestFirst: 'lowest-first',
+};
+/** Human-readable percentile bracket */
+exports.PercentileLabels = {
+    top1: 'top-1%',
+    top5: 'top-5%',
+    top10: 'top-10%',
+    top25: 'top-25%',
+    top50: 'top-50%',
+    bottomHalf: 'bottom-half',
+};
+/** Rank movement since previous ranking */
+exports.Movements = {
+    climbed: 'climbed',
+    steady: 'steady',
+    dropped: 'dropped',
+};
+/** Elo K-factor presets controlling rating volatility */
+exports.KFactorPresets = {
+    volatile: 'volatile',
+    standard: 'standard',
+    stable: 'stable',
+};
 exports.K_FACTOR_VALUES = {
     'volatile': 32, // New entities, fast adjustment
     'standard': 16, // Default

package/dist/engines/ranking/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/engines/ranking/types.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAyCH,0CAEC;AAOD,wDAOC;AAGD,0CAIC;AA7BY,QAAA,eAAe,GAAkC;IAC5D,UAAU,EAAE,EAAE,EAAK,gCAAgC;IACnD,UAAU,EAAE,EAAE,EAAK,UAAU;IAC7B,QAAQ,EAAE,CAAC,CAAQ,mCAAmC;CACvD,CAAC;AAEF,SAAgB,eAAe,CAAC,KAAc;IAC5C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,IAAI,uBAAe,CAAC;AAC/D,CAAC;AAED,2CAA2C;AAC3C,qBAAqB;AACrB,2CAA2C;AAE3C,mDAAmD;AACnD,SAAgB,sBAAsB,CAAC,UAAkB;IACvD,IAAI,UAAU,IAAI,EAAE;QAAE,OAAO,QAAQ,CAAC;IACtC,IAAI,UAAU,IAAI,EAAE;QAAE,OAAO,QAAQ,CAAC;IACtC,IAAI,UAAU,IAAI,EAAE;QAAE,OAAO,SAAS,CAAC;IACvC,IAAI,UAAU,IAAI,EAAE;QAAE,OAAO,SAAS,CAAC;IACvC,IAAI,UAAU,IAAI,EAAE;QAAE,OAAO,SAAS,CAAC;IACvC,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,mDAAmD;AACnD,SAAgB,eAAe,CAAC,YAAoB,EAAE,WAAmB;IACvE,IAAI,WAAW,GAAG,YAAY;QAAE,OAAO,SAAS,CAAC,CAAG,6BAA6B;IACjF,IAAI,WAAW,GAAG,YAAY;QAAE,OAAO,SAAS,CAAC;IACjD,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/engines/ranking/types.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AA8DH,0CAEC;AAOD,wDAOC;AAGD,0CAIC;AA3ED,2CAA2C;AAC3C,iBAAiB;AACjB,2CAA2C;AAE3C,+BAA+B;AAClB,QAAA,iBAAiB,GAAG;IAC/B,KAAK,EAAE,OAAO;IACd,GAAG,EAAE,KAAK;IACV,UAAU,EAAE,cAAc;CAClB,CAAC;AAGX,kCAAkC;AACrB,QAAA,iBAAiB,GAAG;IAC/B,YAAY,EAAE,eAAe;IAC7B,WAAW,EAAE,cAAc;CACnB,CAAC;AAGX,wCAAwC;AAC3B,QAAA,gBAAgB,GAAG;IAC9B,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,QAAQ;IACd,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,SAAS;IAChB,UAAU,EAAE,aAAa;CACjB,CAAC;AAGX,2CAA2C;AAC9B,QAAA,SAAS,GAAG;IACvB,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;CACV,CAAC;AAGX,yDAAyD;AAC5C,QAAA,cAAc,GAAG;IAC5B,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,QAAQ;CACR,CAAC;AAGE,QAAA,eAAe,GAAkC;IAC5D,UAAU,EAAE,EAAE,EAAK,gCAAgC;IACnD,UAAU,EAAE,EAAE,EAAK,UAAU;IAC7B,QAAQ,EAAE,CAAC,CAAQ,mCAAmC;CACvD,CAAC;AAEF,SAAgB,eAAe,CAAC,KAAc;IAC5C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,IAAI,uBAAe,CAAC;AAC/D,CAAC;AAED,2CAA2C;AAC3C,qBAAqB;AACrB,2CAA2C;AAE3C,mDAAmD;AACnD,SAAgB,sBAAsB,CAAC,UAAkB;IACvD,IAAI,UAAU,IAAI,EAAE;QAAE,OAAO,QAAQ,CAAC;IACtC,IAAI,UAAU,IAAI,EAAE;QAAE,OAAO,QAAQ,CAAC;IACtC,IAAI,UAAU,IAAI,EAAE;QAAE,OAAO,SAAS,CAAC;IACvC,IAAI,UAAU,IAAI,EAAE;QAAE,OAAO,SAAS,CAAC;IACvC,IAAI,UAAU,IAAI,EAAE;QAAE,OAAO,SAAS,CAAC;IACvC,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,mDAAmD;AACnD,SAAgB,eAAe,CAAC,YAAoB,EAAE,WAAmB;IACvE,IAAI,WAAW,GAAG,YAAY;QAAE,OAAO,SAAS,CAAC,CAAG,6BAA6B;IACjF,IAAI,WAAW,GAAG,YAAY;QAAE,OAAO,SAAS,CAAC;IACjD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/engines/recipe-costing/compiler.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Recipe Costing Engine Compiler
+ *
+ * Validates recipe costing rulesets and resolves defaults.
+ */
+import type { RecipeCostingRuleSet, CompiledRecipeCostingRuleSet } from './types';
+/**
+ * Compile and validate a recipe costing ruleset.
+ */
+export declare function compileRecipeCostingRuleSet(ruleSet: RecipeCostingRuleSet): CompiledRecipeCostingRuleSet;
+//# sourceMappingURL=compiler.d.ts.map

package/dist/engines/recipe-costing/compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../../../src/engines/recipe-costing/compiler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EACV,oBAAoB,EACpB,4BAA4B,EAI7B,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,oBAAoB,GAC5B,4BAA4B,CA4F9B"}

package/dist/engines/recipe-costing/compiler.js

@@ -0,0 +1,177 @@
+"use strict";
+/**
+ * Recipe Costing Engine Compiler
+ *
+ * Validates recipe costing rulesets and resolves defaults.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compileRecipeCostingRuleSet = compileRecipeCostingRuleSet;
+const errors_1 = require("../../core/errors");
+/**
+ * Compile and validate a recipe costing ruleset.
+ */
+function compileRecipeCostingRuleSet(ruleSet) {
+    if (!ruleSet.id) {
+        throw new errors_1.CompilationError('Recipe costing ruleset requires an id');
+    }
+    if (ruleSet.mode !== 'recipe-costing') {
+        throw new errors_1.CompilationError(`Expected mode 'recipe-costing', got '${ruleSet.mode}'`);
+    }
+    if (!ruleSet.ingredients || ruleSet.ingredients.length === 0) {
+        throw new errors_1.CompilationError('Recipe costing ruleset requires at least one ingredient');
+    }
+    if (!ruleSet.recipes || ruleSet.recipes.length === 0) {
+        throw new errors_1.CompilationError('Recipe costing ruleset requires at least one recipe');
+    }
+    // Validate unique ingredient IDs
+    const ingredientIds = new Set();
+    for (const ing of ruleSet.ingredients) {
+        if (!ing.id) {
+            throw new errors_1.CompilationError('Each ingredient requires an id');
+        }
+        if (ingredientIds.has(ing.id)) {
+            throw new errors_1.CompilationError(`Duplicate ingredient id: '${ing.id}'`);
+        }
+        if (ing.purchaseQuantity <= 0) {
+            throw new errors_1.CompilationError(`Ingredient '${ing.id}' purchaseQuantity must be positive`);
+        }
+        if (ing.purchaseCost <= 0) {
+            throw new errors_1.CompilationError(`Ingredient '${ing.id}' purchaseCost must be positive`);
+        }
+        if (ing.yieldFactor !== undefined && (ing.yieldFactor <= 0 || ing.yieldFactor > 1)) {
+            throw new errors_1.CompilationError(`Ingredient '${ing.id}' yieldFactor must be in (0, 1]`);
+        }
+        if (ing.wastePct !== undefined && (ing.wastePct < 0 || ing.wastePct >= 100)) {
+            throw new errors_1.CompilationError(`Ingredient '${ing.id}' wastePct must be in [0, 100)`);
+        }
+        ingredientIds.add(ing.id);
+    }
+    // Validate unique recipe IDs
+    const recipeIds = new Set();
+    for (const recipe of ruleSet.recipes) {
+        if (!recipe.id) {
+            throw new errors_1.CompilationError('Each recipe requires an id');
+        }
+        if (recipeIds.has(recipe.id)) {
+            throw new errors_1.CompilationError(`Duplicate recipe id: '${recipe.id}'`);
+        }
+        recipeIds.add(recipe.id);
+    }
+    // Validate recipe components reference valid ingredients or recipes
+    for (const recipe of ruleSet.recipes) {
+        for (const comp of recipe.components) {
+            if (comp.ingredientId && comp.subRecipeId) {
+                throw new errors_1.CompilationError(`Recipe '${recipe.id}' component references both ingredientId and subRecipeId. Must be one or the other.`);
+            }
+            if (!comp.ingredientId && !comp.subRecipeId) {
+                throw new errors_1.CompilationError(`Recipe '${recipe.id}' component must reference an ingredientId or subRecipeId`);
+            }
+            if (comp.ingredientId && !ingredientIds.has(comp.ingredientId)) {
+                throw new errors_1.CompilationError(`Recipe '${recipe.id}' references unknown ingredient: '${comp.ingredientId}'`);
+            }
+            if (comp.subRecipeId && !recipeIds.has(comp.subRecipeId)) {
+                throw new errors_1.CompilationError(`Recipe '${recipe.id}' references unknown sub-recipe: '${comp.subRecipeId}'`);
+            }
+        }
+    }
+    // Detect circular sub-recipe references
+    detectCircularRecipes(ruleSet.recipes);
+    switch (ruleSet.strategy) {
+        case 'plate-cost':
+            return compilePlateCost(ruleSet);
+        case 'margin-analysis':
+            return compileMarginAnalysis(ruleSet);
+        case 'cost-impact':
+            return compileCostImpact(ruleSet);
+        default:
+            throw new errors_1.CompilationError(`Unknown recipe costing strategy: '${ruleSet.strategy}'`);
+    }
+}
+function compilePlateCost(ruleSet) {
+    return {
+        id: ruleSet.id,
+        name: ruleSet.name,
+        mode: 'recipe-costing',
+        strategy: 'plate-cost',
+        ingredients: ruleSet.ingredients,
+        recipes: ruleSet.recipes,
+        config: {
+            targetFoodCostPct: ruleSet.config?.targetFoodCostPct ?? 30
+        }
+    };
+}
+function compileMarginAnalysis(ruleSet) {
+    return {
+        id: ruleSet.id,
+        name: ruleSet.name,
+        mode: 'recipe-costing',
+        strategy: 'margin-analysis',
+        ingredients: ruleSet.ingredients,
+        recipes: ruleSet.recipes,
+        config: {
+            targetFoodCostPct: ruleSet.config?.targetFoodCostPct ?? 30,
+            flagThreshold: ruleSet.config?.flagThreshold ?? 35
+        }
+    };
+}
+function compileCostImpact(ruleSet) {
+    if (!ruleSet.config || !ruleSet.config.changes || ruleSet.config.changes.length === 0) {
+        throw new errors_1.CompilationError('Cost-impact strategy requires at least one cost change');
+    }
+    const ingredientIds = new Set(ruleSet.ingredients.map(i => i.id));
+    for (const change of ruleSet.config.changes) {
+        if (!ingredientIds.has(change.ingredientId)) {
+            throw new errors_1.CompilationError(`Cost change references unknown ingredient: '${change.ingredientId}'`);
+        }
+        if (change.newCost !== undefined && change.percentChange !== undefined) {
+            throw new errors_1.CompilationError(`Cost change for '${change.ingredientId}' must have newCost or percentChange, not both`);
+        }
+        if (change.newCost === undefined && change.percentChange === undefined) {
+            throw new errors_1.CompilationError(`Cost change for '${change.ingredientId}' must have newCost or percentChange`);
+        }
+    }
+    return {
+        id: ruleSet.id,
+        name: ruleSet.name,
+        mode: 'recipe-costing',
+        strategy: 'cost-impact',
+        ingredients: ruleSet.ingredients,
+        recipes: ruleSet.recipes,
+        config: {
+            changes: ruleSet.config.changes,
+            targetFoodCostPct: ruleSet.config.targetFoodCostPct ?? 30
+        }
+    };
+}
+function detectCircularRecipes(recipes) {
+    const adjacency = new Map();
+    for (const recipe of recipes) {
+        const deps = [];
+        for (const comp of recipe.components) {
+            if (comp.subRecipeId) {
+                deps.push(comp.subRecipeId);
+            }
+        }
+        adjacency.set(recipe.id, deps);
+    }
+    const visited = new Set();
+    const inStack = new Set();
+    function dfs(id) {
+        if (inStack.has(id)) {
+            throw new errors_1.CompilationError(`Circular sub-recipe dependency detected involving '${id}'`);
+        }
+        if (visited.has(id))
+            return;
+        visited.add(id);
+        inStack.add(id);
+        const deps = adjacency.get(id) ?? [];
+        for (const dep of deps) {
+            dfs(dep);
+        }
+        inStack.delete(id);
+    }
+    for (const recipe of recipes) {
+        dfs(recipe.id);
+    }
+}
+//# sourceMappingURL=compiler.js.map

package/dist/engines/recipe-costing/compiler.js.map

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

package/dist/engines/recipe-costing/engine.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Recipe Costing Engine
+ *
+ * Computes plate cost by rolling up ingredient costs through a bill of
+ * materials with yield factors and waste percentages. Supports margin
+ * analysis and cost-impact modeling when ingredient prices change.
+ *
+ * @example
+ * ```typescript
+ * const engine = new RecipeCostingEngine();
+ *
+ * const result = engine.execute(compiledRecipeCosting);
+ * // result.recipes -> per-recipe cost breakdowns
+ * ```
+ */
+import type { CompiledRecipeCostingRuleSet, RecipeCostingOptions, RecipeCostingResult } from './types';
+export declare class RecipeCostingEngine {
+    private strategy;
+    constructor();
+    /**
+     * Execute a recipe costing ruleset.
+     *
+     * Computes plate costs, analyzes margins, or models cost impacts
+     * depending on the strategy.
+     *
+     * @param ruleSet - Compiled recipe costing ruleset
+     * @param options - Runtime options
+     * @returns Recipe costing result
+     */
+    execute(ruleSet: CompiledRecipeCostingRuleSet, options?: RecipeCostingOptions): RecipeCostingResult;
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/engines/recipe-costing/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/engines/recipe-costing/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EACV,4BAA4B,EAC5B,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,SAAS,CAAC;AAIjB,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAwB;;IAMxC;;;;;;;;;OASG;IACH,OAAO,CACL,OAAO,EAAE,4BAA4B,EACrC,OAAO,GAAE,oBAAyB,GACjC,mBAAmB;CAGvB"}

package/dist/engines/recipe-costing/engine.js

@@ -0,0 +1,40 @@
+"use strict";
+/**
+ * Recipe Costing Engine
+ *
+ * Computes plate cost by rolling up ingredient costs through a bill of
+ * materials with yield factors and waste percentages. Supports margin
+ * analysis and cost-impact modeling when ingredient prices change.
+ *
+ * @example
+ * ```typescript
+ * const engine = new RecipeCostingEngine();
+ *
+ * const result = engine.execute(compiledRecipeCosting);
+ * // result.recipes -> per-recipe cost breakdowns
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RecipeCostingEngine = void 0;
+const strategy_1 = require("./strategy");
+class RecipeCostingEngine {
+    strategy;
+    constructor() {
+        this.strategy = new strategy_1.RecipeCostingExecutor();
+    }
+    /**
+     * Execute a recipe costing ruleset.
+     *
+     * Computes plate costs, analyzes margins, or models cost impacts
+     * depending on the strategy.
+     *
+     * @param ruleSet - Compiled recipe costing ruleset
+     * @param options - Runtime options
+     * @returns Recipe costing result
+     */
+    execute(ruleSet, options = {}) {
+        return this.strategy.run(ruleSet, options);
+    }
+}
+exports.RecipeCostingEngine = RecipeCostingEngine;
+//# sourceMappingURL=engine.js.map

package/dist/engines/recipe-costing/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../../src/engines/recipe-costing/engine.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAQH,yCAAmD;AAEnD,MAAa,mBAAmB;IACtB,QAAQ,CAAwB;IAExC;QACE,IAAI,CAAC,QAAQ,GAAG,IAAI,gCAAqB,EAAE,CAAC;IAC9C,CAAC;IAED;;;;;;;;;OASG;IACH,OAAO,CACL,OAAqC,EACrC,UAAgC,EAAE;QAElC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;CACF;AAvBD,kDAuBC"}

package/dist/engines/recipe-costing/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Recipe Costing Engine -- Plate Cost & Margin Analysis
+ */
+export type { RecipeCostingStrategy, MeasurementUnit, Ingredient, RecipeComponent, Recipe, CostChange, PlateCostConfig, MarginAnalysisConfig, CostImpactConfig, PlateCostRuleSet, MarginAnalysisRuleSet, CostImpactRuleSet, RecipeCostingRuleSet, CompiledPlateCostRuleSet, CompiledMarginAnalysisRuleSet, CompiledCostImpactRuleSet, CompiledRecipeCostingRuleSet, IngredientCostBreakdown, SubRecipeCostBreakdown, RecipeCostResult, CostImpactItem, PlateCostResult, MarginAnalysisResult, CostImpactResult, RecipeCostingResult, RecipeCostingOptions } from './types';
+export { RecipeCostingStrategies, MeasurementUnits } from './types';
+export { compileRecipeCostingRuleSet } from './compiler';
+export { RecipeCostingExecutor, recipeCostingStrategy } from './strategy';
+export { RecipeCostingEngine } from './engine';
+//# sourceMappingURL=index.d.ts.map

package/dist/engines/recipe-costing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engines/recipe-costing/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,YAAY,EACV,qBAAqB,EACrB,eAAe,EACf,UAAU,EACV,eAAe,EACf,MAAM,EACN,UAAU,EACV,eAAe,EACf,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,oBAAoB,EACpB,wBAAwB,EACxB,6BAA6B,EAC7B,yBAAyB,EACzB,4BAA4B,EAC5B,uBAAuB,EACvB,sBAAsB,EACtB,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAGzD,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAG1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC"}

package/dist/engines/recipe-costing/index.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * Recipe Costing Engine -- Plate Cost & Margin Analysis
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RecipeCostingEngine = exports.recipeCostingStrategy = exports.RecipeCostingExecutor = exports.compileRecipeCostingRuleSet = exports.MeasurementUnits = exports.RecipeCostingStrategies = void 0;
+// Constants
+var types_1 = require("./types");
+Object.defineProperty(exports, "RecipeCostingStrategies", { enumerable: true, get: function () { return types_1.RecipeCostingStrategies; } });
+Object.defineProperty(exports, "MeasurementUnits", { enumerable: true, get: function () { return types_1.MeasurementUnits; } });
+// Compiler
+var compiler_1 = require("./compiler");
+Object.defineProperty(exports, "compileRecipeCostingRuleSet", { enumerable: true, get: function () { return compiler_1.compileRecipeCostingRuleSet; } });
+// Strategy
+var strategy_1 = require("./strategy");
+Object.defineProperty(exports, "RecipeCostingExecutor", { enumerable: true, get: function () { return strategy_1.RecipeCostingExecutor; } });
+Object.defineProperty(exports, "recipeCostingStrategy", { enumerable: true, get: function () { return strategy_1.recipeCostingStrategy; } });
+// Engine
+var engine_1 = require("./engine");
+Object.defineProperty(exports, "RecipeCostingEngine", { enumerable: true, get: function () { return engine_1.RecipeCostingEngine; } });
+//# sourceMappingURL=index.js.map

package/dist/engines/recipe-costing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engines/recipe-costing/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAgCH,YAAY;AACZ,iCAGiB;AAFf,gHAAA,uBAAuB,OAAA;AACvB,yGAAA,gBAAgB,OAAA;AAGlB,WAAW;AACX,uCAAyD;AAAhD,uHAAA,2BAA2B,OAAA;AAEpC,WAAW;AACX,uCAA0E;AAAjE,iHAAA,qBAAqB,OAAA;AAAE,iHAAA,qBAAqB,OAAA;AAErD,SAAS;AACT,mCAA+C;AAAtC,6GAAA,mBAAmB,OAAA"}

package/dist/engines/recipe-costing/strategy.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Recipe Costing Engine Strategy
+ *
+ * Core execution logic for all recipe costing strategies:
+ * - plate-cost: compute plate cost by rolling up ingredient BOM with yield/waste
+ * - margin-analysis: analyze margins and flag high food-cost items
+ * - cost-impact: model ingredient cost changes and their impact on recipes
+ */
+import type { CompiledRecipeCostingRuleSet, RecipeCostingResult, RecipeCostingOptions } from './types';
+export declare class RecipeCostingExecutor {
+    run(ruleSet: CompiledRecipeCostingRuleSet, _options?: RecipeCostingOptions): RecipeCostingResult;
+    private runPlateCost;
+    private runMarginAnalysis;
+    private runCostImpact;
+    private computeRecipeCost;
+    private findAffectedIngredients;
+}
+/** Singleton instance */
+export declare const recipeCostingStrategy: RecipeCostingExecutor;
+//# sourceMappingURL=strategy.d.ts.map

package/dist/engines/recipe-costing/strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy.d.ts","sourceRoot":"","sources":["../../../src/engines/recipe-costing/strategy.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,4BAA4B,EAa5B,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,SAAS,CAAC;AAsBjB,qBAAa,qBAAqB;IAChC,GAAG,CACD,OAAO,EAAE,4BAA4B,EACrC,QAAQ,GAAE,oBAAyB,GAClC,mBAAmB;IAiBtB,OAAO,CAAC,YAAY;IAoBpB,OAAO,CAAC,iBAAiB;IAkDzB,OAAO,CAAC,aAAa;IAqGrB,OAAO,CAAC,iBAAiB;IAyFzB,OAAO,CAAC,uBAAuB;CAyBhC;AAED,yBAAyB;AACzB,eAAO,MAAM,qBAAqB,uBAA8B,CAAC"}