@tmlmt/cooklang-parser 3.0.0-alpha.10 → 3.0.0-alpha.12

package/dist/index.d.cts

@@ -97,6 +97,18 @@ declare class Recipe {
      * @see {@link Recipe.scaleBy | scaleBy()} and {@link Recipe.scaleTo | scaleTo()} methods
      */
     servings?: number;
+    /**
+     * Gets the unit system specified in the recipe metadata.
+     * Used for resolving ambiguous units like tsp, tbsp, cup, etc.
+     *
+     * @returns The unit system if specified, or undefined to use defaults
+     */
+    get unitSystem(): SpecificUnitSystem | undefined;
+    /**
+     * External storage for unit system (not a property on instances).
+     * Used for resolving ambiguous units during quantity addition.
+     */
+    private static unitSystems;
     /**
      * External storage for item count (not a property on instances).
      * Used for giving ID numbers to items during parsing.
@@ -192,6 +204,26 @@ declare class Recipe {
      * @returns A new Recipe instance with the scaled ingredients.
      */
     scaleBy(factor: number | Big): Recipe;
+    /**
+     * Converts all ingredient quantities in the recipe to a target unit system.
+     *
+     * @param system - The target unit system to convert to (metric, US, UK, JP)
+     * @param method - How to handle existing quantities:
+     *   - "keep": Keep all existing equivalents (swap if needed, or add converted)
+     *   - "replace": Replace primary with target system quantity, discard equivalent used for conversion
+     *   - "remove": Only keep target system quantity, delete all equivalents
+     * @returns A new Recipe instance with converted quantities
+     *
+     * @example
+     * ```typescript
+     * // Convert a recipe to metric, keeping original units as equivalents
+     * const metricRecipe = recipe.convertTo("metric", "keep");
+     *
+     * // Convert to US units, removing all other equivalents
+     * const usRecipe = recipe.convertTo("US", "remove");
+     * ```
+     */
+    convertTo(system: SpecificUnitSystem, method: "keep" | "replace" | "remove"): Recipe;
     /**
      * Gets the number of servings for the recipe.
      * @private
@@ -315,6 +347,12 @@ interface Metadata {
     picture?: string;
     /** The introduction of the recipe. */
     introduction?: string;
+    /**
+     * The unit system used in the recipe for ambiguous units like tsp, tbsp, cup.
+     * See [Unit Conversion Guide](/guide-unit-conversion) for more information.
+     * This stores the original value as written by the user.
+     */
+    "unit system"?: string;
 }
 /**
  * Represents a quantity described by text, e.g. "a pinch"
@@ -470,31 +508,27 @@ interface Ingredient {
     /** The collection of potential additional metadata for the ingredient */
     extras?: IngredientExtras;
 }
-/**
- * Represents a contributor to an ingredient's total quantity, corresponding
- * to a single mention in the recipe text. It can contain multiple
- * equivalent quantities (e.g., in different units).
- * @category Types
- */
-interface IngredientItemQuantity extends QuantityWithExtendedUnit {
-    /**
-     * A list of equivalent quantities/units for this ingredient mention besides the primary quantity.
-     * For `@salt{1%tsp|5%g}`, the main quantity is 1 tsp and the equivalents will contain 5 g.
-     */
-    equivalents?: QuantityWithExtendedUnit[];
+type MaybeScalableQuantity = QuantityWithExtendedUnit & {
     /** Indicates whether this quantity should be scaled when the recipe serving size changes. */
     scalable: boolean;
-}
+    /** A list of equivalent quantities/units for this ingredient mention besides the primary quantity.
+     * For `@salt{1%tsp|5%g}`, the main quantity is 1 tsp and the equivalents will contain 5 g. */
+    equivalents?: QuantityWithExtendedUnit[];
+};
+type WithOptionalQuantity<T> = (T & MaybeScalableQuantity) | (T & {
+    quantity?: undefined;
+    scalable?: never;
+    unit?: never;
+    equivalents?: never;
+});
 /**
  * Represents a single ingredient choice within a single or a group of `IngredientItem`s. It points
  * to a specific ingredient and its corresponding quantity information.
  * @category Types
  */
-interface IngredientAlternative {
+type IngredientAlternativeBase = {
     /** The index of the ingredient within the {@link Recipe.ingredients} array. */
     index: number;
-    /** The quantity of this specific mention of the ingredient */
-    itemQuantity?: IngredientItemQuantity;
     /** The alias/name of the ingredient as it should be displayed for this occurrence. */
     displayName: string;
     /** An optional note for this specific choice (e.g., "for a vegan version"). */
@@ -503,7 +537,8 @@ interface IngredientAlternative {
      * with group keys: the id of the corresponding ingredient item (e.g. "ingredient-item-2").
      * Can be useful for creating alternative selection UI elements with anchor links */
     itemId?: string;
-}
+};
+type IngredientAlternative = WithOptionalQuantity<IngredientAlternativeBase>;
 /**
  * Represents an ingredient item in a recipe step.
  * @category Types
@@ -853,12 +888,23 @@ type CartMisMatch = ProductMisMatch[];
  * Represents the type category of a unit used for quantities
  * @category Types
  */
-type UnitType = "mass" | "volume" | "count";
+type UnitType = "mass" | "volume" | "count" | "other";
+/**
+ * Represents the specific measurement systems
+ * @category Types
+ */
+type SpecificUnitSystem = "metric" | "US" | "UK" | "JP";
 /**
  * Represents the measurement system a unit belongs to
  * @category Types
  */
-type UnitSystem = "metric" | "imperial";
+type UnitSystem = SpecificUnitSystem | "ambiguous";
+/**
+ * Conversion factors for ambiguous units that can belong to multiple systems.
+ * Maps each possible system to its toBase conversion factor.
+ * @category Types
+ */
+type ToBaseBySystem = Partial<Record<SpecificUnitSystem, number>>;
 /**
  * Represents a unit used to describe quantities
  * @category Types
@@ -878,8 +924,28 @@ interface UnitDefinition extends Unit {
     system: UnitSystem;
     /** e.g. ['gram', 'grams'] */
     aliases: string[];
-    /** Conversion factor to the base unit of its type */
+    /** Conversion factor to the base unit of its type (uses default system for ambiguous units) */
     toBase: number;
+    /** For ambiguous units: conversion factors for each possible system */
+    toBaseBySystem?: ToBaseBySystem;
+    /** Whether this unit is a candidate for "best unit" selection (default: true) */
+    isBestUnit?: boolean;
+    /** Maximum value before upgrading to a larger unit (default: 999) */
+    maxValue?: number;
+    /** Fraction display configuration */
+    fractions?: UnitFractionConfig;
+}
+/**
+ * Configuration for fraction display on a unit
+ * @category Types
+ */
+interface UnitFractionConfig {
+    /** Whether to approximate decimals as fractions for this unit */
+    enabled: boolean;
+    /** Allowed denominators (default: [2, 3, 4, 8]) */
+    denominators?: number[];
+    /** Maximum whole number in mixed fraction before falling back to decimal (default: 4) */
+    maxWhole?: number;
 }
 /**
  * Represents a resolved unit definition or a lightweight placeholder for non-standard units
@@ -1313,10 +1379,30 @@ declare class ShoppingCart {
     summarize(): ShoppingCartSummary;
 }
 
+/**
+ * Render a fraction using Unicode vulgar fraction characters when available.
+ * Handles improper fractions by extracting the whole part (e.g., 5/4 → "1¼").
+ *
+ * @param num - The numerator
+ * @param den - The denominator
+ * @returns The fraction as a string, using vulgar characters if available
+ * @category Helpers
+ *
+ * @example
+ * ```typescript
+ * renderFractionAsVulgar(1, 2); // "½"
+ * renderFractionAsVulgar(3, 4); // "¾"
+ * renderFractionAsVulgar(5, 4); // "1¼"
+ * renderFractionAsVulgar(7, 3); // "2⅓"
+ * renderFractionAsVulgar(2, 5); // "2/5" (no vulgar character available)
+ * ```
+ */
+declare function renderFractionAsVulgar(num: number, den: number): string;
 /**
  * Format a numeric value (decimal or fraction) to a string.
  *
  * @param value - The decimal or fraction value to format
+ * @param useVulgar - Whether to use Unicode vulgar fraction characters (default: false)
  * @returns The formatted string representation
  * @category Helpers
  *
@@ -1324,9 +1410,11 @@ declare class ShoppingCart {
  * ```typescript
  * formatNumericValue({ type: "decimal", decimal: 1.5 }); // "1.5"
  * formatNumericValue({ type: "fraction", num: 1, den: 2 }); // "1/2"
+ * formatNumericValue({ type: "fraction", num: 1, den: 2 }, true); // "½"
+ * formatNumericValue({ type: "fraction", num: 5, den: 4 }, true); // "1¼"
  * ```
  */
-declare function formatNumericValue(value: DecimalValue | FractionValue): string;
+declare function formatNumericValue(value: DecimalValue | FractionValue, useVulgar?: boolean): string;
 /**
  * Format a single value (text, decimal, or fraction) to a string.
  *
@@ -1409,7 +1497,7 @@ declare function formatExtendedQuantity(item: QuantityWithExtendedUnit): string;
  * formatItemQuantity(itemQuantity, " / "); // "100 g / 3.5 oz"
  * ```
  */
-declare function formatItemQuantity(itemQuantity: IngredientItemQuantity, separator?: string): string;
+declare function formatItemQuantity(itemQuantity: MaybeScalableQuantity, separator?: string): string;
 /**
  * Check if an ingredient item is a grouped alternative (vs inline alternative).
  *
@@ -1523,6 +1611,19 @@ declare function hasAlternatives(entry: IngredientQuantityGroup | IngredientQuan
     alternatives: AlternativeIngredientRef[];
 };
 
+/**
+ * Converts a quantity to the best unit in a target system.
+ * Returns the converted quantity, or undefined if the unit type is "other" or not convertible.
+ *
+ * @category Helpers
+ *
+ * @param quantity - The quantity to convert
+ * @param system - The target unit system
+ * @returns The converted quantity, or undefined if conversion not possible
+ */
+declare function convertQuantityToSystem(quantity: QuantityWithPlainUnit, system: SpecificUnitSystem): QuantityWithPlainUnit | undefined;
+declare function convertQuantityToSystem(quantity: QuantityWithExtendedUnit, system: SpecificUnitSystem): QuantityWithExtendedUnit | undefined;
+
 /**
  * Error thrown when trying to build a shopping cart without a product catalog
  * @category Errors
@@ -1538,4 +1639,4 @@ declare class NoShoppingListForCartError extends Error {
     constructor();
 }
 
-export { type AddedIngredient, type AddedRecipe, type AddedRecipeOptions, type AlternativeIngredientRef, type AndGroup, type ArbitraryScalable, type ArbitraryScalableItem, type CartContent, type CartMatch, type CartMisMatch, type CategorizedIngredients, type Category, CategoryConfig, type CategoryIngredient, type Cookware, type CookwareFlag, type CookwareItem, type DecimalValue, type FixedNumericValue, type FixedValue, type FlatAndGroup, type FlatGroup, type FlatOrGroup, type FractionValue, type GetIngredientQuantitiesOptions, type Group, type Ingredient, type IngredientAlternative, type IngredientExtras, type IngredientFlag, type IngredientItem, type IngredientItemQuantity, type IngredientQuantityAndGroup, type IngredientQuantityGroup, type MaybeNestedAndGroup, type MaybeNestedGroup, type MaybeNestedOrGroup, type Metadata, NoProductCatalogForCartError, type NoProductMatchErrorCode, NoShoppingListForCartError, type Note, type NoteItem, type OrGroup, ProductCatalog, type ProductMatch, type ProductMisMatch, type ProductOption, type ProductOptionBase, type ProductOptionCore, type ProductSelection, type ProductSize, type QuantityBase, type QuantityWithExtendedUnit, type QuantityWithPlainUnit, type QuantityWithUnitDef, type QuantityWithUnitLike, type Range, Recipe, type RecipeAlternatives, type RecipeChoices, type RecipeWithFactor, type RecipeWithServings, Section, ShoppingCart, type ShoppingCartOptions, type ShoppingCartSummary, ShoppingList, type Step, type StepItem, type TextItem, type TextValue, type Timer, type TimerItem, type Unit, type UnitDefinition, type UnitDefinitionLike, type UnitSystem, type UnitType, formatExtendedQuantity, formatItemQuantity, formatNumericValue, formatQuantity, formatQuantityWithUnit, formatSingleValue, formatUnit, hasAlternatives, isAlternativeSelected, isAndGroup, isGroupedItem, isSimpleGroup };
+export { type AddedIngredient, type AddedRecipe, type AddedRecipeOptions, type AlternativeIngredientRef, type AndGroup, type ArbitraryScalable, type ArbitraryScalableItem, type CartContent, type CartMatch, type CartMisMatch, type CategorizedIngredients, type Category, CategoryConfig, type CategoryIngredient, type Cookware, type CookwareFlag, type CookwareItem, type DecimalValue, type FixedNumericValue, type FixedValue, type FlatAndGroup, type FlatGroup, type FlatOrGroup, type FractionValue, type GetIngredientQuantitiesOptions, type Group, type Ingredient, type IngredientAlternative, type IngredientExtras, type IngredientFlag, type IngredientItem, type IngredientQuantityAndGroup, type IngredientQuantityGroup, type MaybeNestedAndGroup, type MaybeNestedGroup, type MaybeNestedOrGroup, type MaybeScalableQuantity, type Metadata, NoProductCatalogForCartError, type NoProductMatchErrorCode, NoShoppingListForCartError, type Note, type NoteItem, type OrGroup, ProductCatalog, type ProductMatch, type ProductMisMatch, type ProductOption, type ProductOptionBase, type ProductOptionCore, type ProductSelection, type ProductSize, type QuantityBase, type QuantityWithExtendedUnit, type QuantityWithPlainUnit, type QuantityWithUnitDef, type QuantityWithUnitLike, type Range, Recipe, type RecipeAlternatives, type RecipeChoices, type RecipeWithFactor, type RecipeWithServings, Section, ShoppingCart, type ShoppingCartOptions, type ShoppingCartSummary, ShoppingList, type SpecificUnitSystem, type Step, type StepItem, type TextItem, type TextValue, type Timer, type TimerItem, type ToBaseBySystem, type Unit, type UnitDefinition, type UnitDefinitionLike, type UnitSystem, type UnitType, convertQuantityToSystem, formatExtendedQuantity, formatItemQuantity, formatNumericValue, formatQuantity, formatQuantityWithUnit, formatSingleValue, formatUnit, hasAlternatives, isAlternativeSelected, isAndGroup, isGroupedItem, isSimpleGroup, renderFractionAsVulgar };

package/dist/index.d.ts

@@ -97,6 +97,18 @@ declare class Recipe {
      * @see {@link Recipe.scaleBy | scaleBy()} and {@link Recipe.scaleTo | scaleTo()} methods
      */
     servings?: number;
+    /**
+     * Gets the unit system specified in the recipe metadata.
+     * Used for resolving ambiguous units like tsp, tbsp, cup, etc.
+     *
+     * @returns The unit system if specified, or undefined to use defaults
+     */
+    get unitSystem(): SpecificUnitSystem | undefined;
+    /**
+     * External storage for unit system (not a property on instances).
+     * Used for resolving ambiguous units during quantity addition.
+     */
+    private static unitSystems;
     /**
      * External storage for item count (not a property on instances).
      * Used for giving ID numbers to items during parsing.
@@ -192,6 +204,26 @@ declare class Recipe {
      * @returns A new Recipe instance with the scaled ingredients.
      */
     scaleBy(factor: number | Big): Recipe;
+    /**
+     * Converts all ingredient quantities in the recipe to a target unit system.
+     *
+     * @param system - The target unit system to convert to (metric, US, UK, JP)
+     * @param method - How to handle existing quantities:
+     *   - "keep": Keep all existing equivalents (swap if needed, or add converted)
+     *   - "replace": Replace primary with target system quantity, discard equivalent used for conversion
+     *   - "remove": Only keep target system quantity, delete all equivalents
+     * @returns A new Recipe instance with converted quantities
+     *
+     * @example
+     * ```typescript
+     * // Convert a recipe to metric, keeping original units as equivalents
+     * const metricRecipe = recipe.convertTo("metric", "keep");
+     *
+     * // Convert to US units, removing all other equivalents
+     * const usRecipe = recipe.convertTo("US", "remove");
+     * ```
+     */
+    convertTo(system: SpecificUnitSystem, method: "keep" | "replace" | "remove"): Recipe;
     /**
      * Gets the number of servings for the recipe.
      * @private
@@ -315,6 +347,12 @@ interface Metadata {
     picture?: string;
     /** The introduction of the recipe. */
     introduction?: string;
+    /**
+     * The unit system used in the recipe for ambiguous units like tsp, tbsp, cup.
+     * See [Unit Conversion Guide](/guide-unit-conversion) for more information.
+     * This stores the original value as written by the user.
+     */
+    "unit system"?: string;
 }
 /**
  * Represents a quantity described by text, e.g. "a pinch"
@@ -470,31 +508,27 @@ interface Ingredient {
     /** The collection of potential additional metadata for the ingredient */
     extras?: IngredientExtras;
 }
-/**
- * Represents a contributor to an ingredient's total quantity, corresponding
- * to a single mention in the recipe text. It can contain multiple
- * equivalent quantities (e.g., in different units).
- * @category Types
- */
-interface IngredientItemQuantity extends QuantityWithExtendedUnit {
-    /**
-     * A list of equivalent quantities/units for this ingredient mention besides the primary quantity.
-     * For `@salt{1%tsp|5%g}`, the main quantity is 1 tsp and the equivalents will contain 5 g.
-     */
-    equivalents?: QuantityWithExtendedUnit[];
+type MaybeScalableQuantity = QuantityWithExtendedUnit & {
     /** Indicates whether this quantity should be scaled when the recipe serving size changes. */
     scalable: boolean;
-}
+    /** A list of equivalent quantities/units for this ingredient mention besides the primary quantity.
+     * For `@salt{1%tsp|5%g}`, the main quantity is 1 tsp and the equivalents will contain 5 g. */
+    equivalents?: QuantityWithExtendedUnit[];
+};
+type WithOptionalQuantity<T> = (T & MaybeScalableQuantity) | (T & {
+    quantity?: undefined;
+    scalable?: never;
+    unit?: never;
+    equivalents?: never;
+});
 /**
  * Represents a single ingredient choice within a single or a group of `IngredientItem`s. It points
  * to a specific ingredient and its corresponding quantity information.
  * @category Types
  */
-interface IngredientAlternative {
+type IngredientAlternativeBase = {
     /** The index of the ingredient within the {@link Recipe.ingredients} array. */
     index: number;
-    /** The quantity of this specific mention of the ingredient */
-    itemQuantity?: IngredientItemQuantity;
     /** The alias/name of the ingredient as it should be displayed for this occurrence. */
     displayName: string;
     /** An optional note for this specific choice (e.g., "for a vegan version"). */
@@ -503,7 +537,8 @@ interface IngredientAlternative {
      * with group keys: the id of the corresponding ingredient item (e.g. "ingredient-item-2").
      * Can be useful for creating alternative selection UI elements with anchor links */
     itemId?: string;
-}
+};
+type IngredientAlternative = WithOptionalQuantity<IngredientAlternativeBase>;
 /**
  * Represents an ingredient item in a recipe step.
  * @category Types
@@ -853,12 +888,23 @@ type CartMisMatch = ProductMisMatch[];
  * Represents the type category of a unit used for quantities
  * @category Types
  */
-type UnitType = "mass" | "volume" | "count";
+type UnitType = "mass" | "volume" | "count" | "other";
+/**
+ * Represents the specific measurement systems
+ * @category Types
+ */
+type SpecificUnitSystem = "metric" | "US" | "UK" | "JP";
 /**
  * Represents the measurement system a unit belongs to
  * @category Types
  */
-type UnitSystem = "metric" | "imperial";
+type UnitSystem = SpecificUnitSystem | "ambiguous";
+/**
+ * Conversion factors for ambiguous units that can belong to multiple systems.
+ * Maps each possible system to its toBase conversion factor.
+ * @category Types
+ */
+type ToBaseBySystem = Partial<Record<SpecificUnitSystem, number>>;
 /**
  * Represents a unit used to describe quantities
  * @category Types
@@ -878,8 +924,28 @@ interface UnitDefinition extends Unit {
     system: UnitSystem;
     /** e.g. ['gram', 'grams'] */
     aliases: string[];
-    /** Conversion factor to the base unit of its type */
+    /** Conversion factor to the base unit of its type (uses default system for ambiguous units) */
     toBase: number;
+    /** For ambiguous units: conversion factors for each possible system */
+    toBaseBySystem?: ToBaseBySystem;
+    /** Whether this unit is a candidate for "best unit" selection (default: true) */
+    isBestUnit?: boolean;
+    /** Maximum value before upgrading to a larger unit (default: 999) */
+    maxValue?: number;
+    /** Fraction display configuration */
+    fractions?: UnitFractionConfig;
+}
+/**
+ * Configuration for fraction display on a unit
+ * @category Types
+ */
+interface UnitFractionConfig {
+    /** Whether to approximate decimals as fractions for this unit */
+    enabled: boolean;
+    /** Allowed denominators (default: [2, 3, 4, 8]) */
+    denominators?: number[];
+    /** Maximum whole number in mixed fraction before falling back to decimal (default: 4) */
+    maxWhole?: number;
 }
 /**
  * Represents a resolved unit definition or a lightweight placeholder for non-standard units
@@ -1313,10 +1379,30 @@ declare class ShoppingCart {
     summarize(): ShoppingCartSummary;
 }
 
+/**
+ * Render a fraction using Unicode vulgar fraction characters when available.
+ * Handles improper fractions by extracting the whole part (e.g., 5/4 → "1¼").
+ *
+ * @param num - The numerator
+ * @param den - The denominator
+ * @returns The fraction as a string, using vulgar characters if available
+ * @category Helpers
+ *
+ * @example
+ * ```typescript
+ * renderFractionAsVulgar(1, 2); // "½"
+ * renderFractionAsVulgar(3, 4); // "¾"
+ * renderFractionAsVulgar(5, 4); // "1¼"
+ * renderFractionAsVulgar(7, 3); // "2⅓"
+ * renderFractionAsVulgar(2, 5); // "2/5" (no vulgar character available)
+ * ```
+ */
+declare function renderFractionAsVulgar(num: number, den: number): string;
 /**
  * Format a numeric value (decimal or fraction) to a string.
  *
  * @param value - The decimal or fraction value to format
+ * @param useVulgar - Whether to use Unicode vulgar fraction characters (default: false)
  * @returns The formatted string representation
  * @category Helpers
  *
@@ -1324,9 +1410,11 @@ declare class ShoppingCart {
  * ```typescript
  * formatNumericValue({ type: "decimal", decimal: 1.5 }); // "1.5"
  * formatNumericValue({ type: "fraction", num: 1, den: 2 }); // "1/2"
+ * formatNumericValue({ type: "fraction", num: 1, den: 2 }, true); // "½"
+ * formatNumericValue({ type: "fraction", num: 5, den: 4 }, true); // "1¼"
  * ```
  */
-declare function formatNumericValue(value: DecimalValue | FractionValue): string;
+declare function formatNumericValue(value: DecimalValue | FractionValue, useVulgar?: boolean): string;
 /**
  * Format a single value (text, decimal, or fraction) to a string.
  *
@@ -1409,7 +1497,7 @@ declare function formatExtendedQuantity(item: QuantityWithExtendedUnit): string;
  * formatItemQuantity(itemQuantity, " / "); // "100 g / 3.5 oz"
  * ```
  */
-declare function formatItemQuantity(itemQuantity: IngredientItemQuantity, separator?: string): string;
+declare function formatItemQuantity(itemQuantity: MaybeScalableQuantity, separator?: string): string;
 /**
  * Check if an ingredient item is a grouped alternative (vs inline alternative).
  *
@@ -1523,6 +1611,19 @@ declare function hasAlternatives(entry: IngredientQuantityGroup | IngredientQuan
     alternatives: AlternativeIngredientRef[];
 };
 
+/**
+ * Converts a quantity to the best unit in a target system.
+ * Returns the converted quantity, or undefined if the unit type is "other" or not convertible.
+ *
+ * @category Helpers
+ *
+ * @param quantity - The quantity to convert
+ * @param system - The target unit system
+ * @returns The converted quantity, or undefined if conversion not possible
+ */
+declare function convertQuantityToSystem(quantity: QuantityWithPlainUnit, system: SpecificUnitSystem): QuantityWithPlainUnit | undefined;
+declare function convertQuantityToSystem(quantity: QuantityWithExtendedUnit, system: SpecificUnitSystem): QuantityWithExtendedUnit | undefined;
+
 /**
  * Error thrown when trying to build a shopping cart without a product catalog
  * @category Errors
@@ -1538,4 +1639,4 @@ declare class NoShoppingListForCartError extends Error {
     constructor();
 }
 
-export { type AddedIngredient, type AddedRecipe, type AddedRecipeOptions, type AlternativeIngredientRef, type AndGroup, type ArbitraryScalable, type ArbitraryScalableItem, type CartContent, type CartMatch, type CartMisMatch, type CategorizedIngredients, type Category, CategoryConfig, type CategoryIngredient, type Cookware, type CookwareFlag, type CookwareItem, type DecimalValue, type FixedNumericValue, type FixedValue, type FlatAndGroup, type FlatGroup, type FlatOrGroup, type FractionValue, type GetIngredientQuantitiesOptions, type Group, type Ingredient, type IngredientAlternative, type IngredientExtras, type IngredientFlag, type IngredientItem, type IngredientItemQuantity, type IngredientQuantityAndGroup, type IngredientQuantityGroup, type MaybeNestedAndGroup, type MaybeNestedGroup, type MaybeNestedOrGroup, type Metadata, NoProductCatalogForCartError, type NoProductMatchErrorCode, NoShoppingListForCartError, type Note, type NoteItem, type OrGroup, ProductCatalog, type ProductMatch, type ProductMisMatch, type ProductOption, type ProductOptionBase, type ProductOptionCore, type ProductSelection, type ProductSize, type QuantityBase, type QuantityWithExtendedUnit, type QuantityWithPlainUnit, type QuantityWithUnitDef, type QuantityWithUnitLike, type Range, Recipe, type RecipeAlternatives, type RecipeChoices, type RecipeWithFactor, type RecipeWithServings, Section, ShoppingCart, type ShoppingCartOptions, type ShoppingCartSummary, ShoppingList, type Step, type StepItem, type TextItem, type TextValue, type Timer, type TimerItem, type Unit, type UnitDefinition, type UnitDefinitionLike, type UnitSystem, type UnitType, formatExtendedQuantity, formatItemQuantity, formatNumericValue, formatQuantity, formatQuantityWithUnit, formatSingleValue, formatUnit, hasAlternatives, isAlternativeSelected, isAndGroup, isGroupedItem, isSimpleGroup };
+export { type AddedIngredient, type AddedRecipe, type AddedRecipeOptions, type AlternativeIngredientRef, type AndGroup, type ArbitraryScalable, type ArbitraryScalableItem, type CartContent, type CartMatch, type CartMisMatch, type CategorizedIngredients, type Category, CategoryConfig, type CategoryIngredient, type Cookware, type CookwareFlag, type CookwareItem, type DecimalValue, type FixedNumericValue, type FixedValue, type FlatAndGroup, type FlatGroup, type FlatOrGroup, type FractionValue, type GetIngredientQuantitiesOptions, type Group, type Ingredient, type IngredientAlternative, type IngredientExtras, type IngredientFlag, type IngredientItem, type IngredientQuantityAndGroup, type IngredientQuantityGroup, type MaybeNestedAndGroup, type MaybeNestedGroup, type MaybeNestedOrGroup, type MaybeScalableQuantity, type Metadata, NoProductCatalogForCartError, type NoProductMatchErrorCode, NoShoppingListForCartError, type Note, type NoteItem, type OrGroup, ProductCatalog, type ProductMatch, type ProductMisMatch, type ProductOption, type ProductOptionBase, type ProductOptionCore, type ProductSelection, type ProductSize, type QuantityBase, type QuantityWithExtendedUnit, type QuantityWithPlainUnit, type QuantityWithUnitDef, type QuantityWithUnitLike, type Range, Recipe, type RecipeAlternatives, type RecipeChoices, type RecipeWithFactor, type RecipeWithServings, Section, ShoppingCart, type ShoppingCartOptions, type ShoppingCartSummary, ShoppingList, type SpecificUnitSystem, type Step, type StepItem, type TextItem, type TextValue, type Timer, type TimerItem, type ToBaseBySystem, type Unit, type UnitDefinition, type UnitDefinitionLike, type UnitSystem, type UnitType, convertQuantityToSystem, formatExtendedQuantity, formatItemQuantity, formatNumericValue, formatQuantity, formatQuantityWithUnit, formatSingleValue, formatUnit, hasAlternatives, isAlternativeSelected, isAndGroup, isGroupedItem, isSimpleGroup, renderFractionAsVulgar };