soustack 0.3.0 → 0.4.0

package/dist/index.d.mts

@@ -9,15 +9,17 @@ interface SoustackRecipe {
     $schema?: string;
     /** Optional declared validation profile */
     profile?: string;
-    /** Enabled module identifiers (e.g., "nutrition@1") */
-    modules?: string[];
-    /** Attribution module payload */
+    /** Recipe level: "lite" or "base" */
+    level?: "lite" | "base";
+    /** Stack declarations as a map: Record<stackName, versionNumber> */
+    stacks?: Record<string, number>;
+    /** Attribution stack payload */
     attribution?: AttributionModule;
-    /** Taxonomy module payload */
+    /** Taxonomy stack payload */
     taxonomy?: TaxonomyModule;
-    /** Media module payload */
+    /** Media stack payload */
     media?: MediaModule;
-    /** Times module payload */
+    /** Times stack payload */
     times?: TimesModule;
     /** Unique identifier (slug or UUID) */
     id?: string;
@@ -254,32 +256,76 @@ interface ScaleRecipeOptions {
 }
 declare function scaleRecipe(recipe: Recipe, options?: ScaleRecipeOptions): Recipe;
 
-type ProfileName = "minimal" | "core";
-interface NormalizedError {
+type ConformanceSeverity = "error" | "warning";
+interface ConformanceIssue {
+    code: string;
     path: string;
     message: string;
-    keyword?: string;
+    severity: ConformanceSeverity;
 }
-interface NormalizedWarning {
+
+type ProfileName = "base" | "equipped" | "illustrated" | "lite" | "prepped" | "scalable" | "timed" | "minimal" | "core";
+interface NormalizedError {
     path: string;
     message: string;
+    keyword?: string;
 }
+/**
+ * Validation modes for recipe validation.
+ * - "schema": JSON Schema only
+ * - "full": JSON Schema + semantic conformance checks
+ */
+type ValidateMode = "schema" | "full";
 interface ValidateOptions {
     profile?: ProfileName;
     schema?: string;
     collectAllErrors?: boolean;
+    mode?: ValidateMode;
+    includeNormalized?: boolean;
 }
-interface ValidationResult {
-    valid: boolean;
-    errors: NormalizedError[];
-    warnings: NormalizedWarning[];
-    normalized?: Recipe;
+/**
+ * Result payload for recipe validation. Schema validation always runs first;
+ * conformance issues are only included when running in full mode.
+ */
+interface ValidateResult {
+    ok: boolean;
+    schemaErrors: NormalizedError[];
+    conformanceIssues: ConformanceIssue[];
+    warnings: string[];
+    normalizedRecipe?: Recipe;
 }
-declare function validateRecipe(input: any, options?: ValidateOptions): ValidationResult;
+/**
+ * Legacy validateRecipe function - now uses the new validateRecipeSchema internally
+ * but maintains backward compatibility with profile/stack-based validation
+ * Also includes semantic conformance validation.
+ */
+/**
+ * Validates a recipe with explicit validation modes.
+ * - mode="schema": JSON Schema only
+ * - mode="full": schema + semantic conformance (only if schema passes)
+ */
+declare function validateRecipe(input: any, options?: ValidateOptions): ValidateResult;
 declare function detectProfiles(recipe: any): ProfileName[];
 
 declare function fromSchemaOrg(input: unknown): Recipe | null;
 
+interface NormalizationResult {
+    recipe: Recipe;
+    warnings: string[];
+}
+/**
+ * Normalizes a recipe input to the current spec format:
+ * - Rejects inputs with legacy field (unsupported)
+ * - Converts legacy `stacks` array format to map format
+ * - Ensures `stacks` exists even if empty
+ * - Preserves existing `stacks` map format
+ *
+ * @param input - Raw recipe input (may have legacy formats)
+ * @returns Normalized recipe with warnings for any issues encountered
+ * @throws Error if input contains legacy field
+ */
+declare function normalizeRecipe(input: unknown): NormalizationResult;
+
 interface SchemaOrgRecipe$1 {
     '@context'?: string | Array<string | Record<string, unknown>> | Record<string, unknown>;
     '@type'?: string | string[];
@@ -352,8 +398,8 @@ interface NutritionInformation {
  * Convert a Soustack recipe to Schema.org JSON-LD format.
  *
  * BREAKING CHANGE in v0.3.0: This function now targets the "minimal" profile
- * and only includes modules that are schemaOrgMappable (as defined in the
- * modules registry). Non-mappable modules (e.g., nutrition@1, schedule@1)
+ * and only includes stacks that are schemaOrgMappable (as defined in the
+ * stacks registry). Non-mappable stacks (e.g., nutrition@1, schedule@1)
  * are excluded from the conversion.
  */
 declare function toSchemaOrg(recipe: Recipe): SchemaOrgRecipe$1;
@@ -448,4 +494,4 @@ interface MiseEnPlacePlan {
 }
 declare function miseEnPlace(ingredients: Ingredient[]): MiseEnPlacePlan;
 
-export { type Alternative, type AttributionModule, type ConvertMode, type ConvertTarget, type ConvertedLineItem, type Equipment, type FrozenStorageMethod, type Ingredient$1 as Ingredient, type IngredientItem, type IngredientSubsection, type Instruction, type InstructionItem, type InstructionSubsection, type LineItem, type MakeAheadComponent, type MediaModule, type Ingredient as MiseEnPlaceIngredient, type MiseEnPlacePlan, type Quantity as MiseEnPlaceQuantity, type MiseEnPlaceTask, MissingEquivalencyError, type NutritionFacts, type ParsedIngredient, type ParsedYield, type Quantity$1 as Quantity, type Recipe, type RoundMode, SOUSTACK_SPEC_VERSION, type Scaling, type ScalingBakersPercentage, type ScalingBase, type ScalingDiscrete, type ScalingFixed, type ScalingLinear, type ScalingProportional, type SimpleTime, type Source, type SoustackInstruction, type SoustackRecipe, type StepTiming, type Storage, type StorageMethod, type StructuredTime, type Substitution, type TaxonomyModule, type Time, type TimesModule, UnknownUnitError, UnsupportedConversionError, type Yield, convertLineItemToMetric, detectProfiles, extractSchemaOrgRecipeFromHTML, fromSchemaOrg, miseEnPlace, scaleRecipe, toSchemaOrg, validateRecipe };
+export { type Alternative, type AttributionModule, type ConvertMode, type ConvertTarget, type ConvertedLineItem, type Equipment, type FrozenStorageMethod, type Ingredient$1 as Ingredient, type IngredientItem, type IngredientSubsection, type Instruction, type InstructionItem, type InstructionSubsection, type LineItem, type MakeAheadComponent, type MediaModule, type Ingredient as MiseEnPlaceIngredient, type MiseEnPlacePlan, type Quantity as MiseEnPlaceQuantity, type MiseEnPlaceTask, MissingEquivalencyError, type NormalizationResult, type NutritionFacts, type ParsedIngredient, type ParsedYield, type Quantity$1 as Quantity, type Recipe, type RoundMode, SOUSTACK_SPEC_VERSION, type Scaling, type ScalingBakersPercentage, type ScalingBase, type ScalingDiscrete, type ScalingFixed, type ScalingLinear, type ScalingProportional, type SimpleTime, type Source, type SoustackInstruction, type SoustackRecipe, type StepTiming, type Storage, type StorageMethod, type StructuredTime, type Substitution, type TaxonomyModule, type Time, type TimesModule, UnknownUnitError, UnsupportedConversionError, type ValidateMode, type ValidateResult, type Yield, convertLineItemToMetric, detectProfiles, extractSchemaOrgRecipeFromHTML, fromSchemaOrg, miseEnPlace, normalizeRecipe, scaleRecipe, toSchemaOrg, validateRecipe };

package/dist/index.d.ts

@@ -9,15 +9,17 @@ interface SoustackRecipe {
     $schema?: string;
     /** Optional declared validation profile */
     profile?: string;
-    /** Enabled module identifiers (e.g., "nutrition@1") */
-    modules?: string[];
-    /** Attribution module payload */
+    /** Recipe level: "lite" or "base" */
+    level?: "lite" | "base";
+    /** Stack declarations as a map: Record<stackName, versionNumber> */
+    stacks?: Record<string, number>;
+    /** Attribution stack payload */
     attribution?: AttributionModule;
-    /** Taxonomy module payload */
+    /** Taxonomy stack payload */
     taxonomy?: TaxonomyModule;
-    /** Media module payload */
+    /** Media stack payload */
     media?: MediaModule;
-    /** Times module payload */
+    /** Times stack payload */
     times?: TimesModule;
     /** Unique identifier (slug or UUID) */
     id?: string;
@@ -254,32 +256,76 @@ interface ScaleRecipeOptions {
 }
 declare function scaleRecipe(recipe: Recipe, options?: ScaleRecipeOptions): Recipe;
 
-type ProfileName = "minimal" | "core";
-interface NormalizedError {
+type ConformanceSeverity = "error" | "warning";
+interface ConformanceIssue {
+    code: string;
     path: string;
     message: string;
-    keyword?: string;
+    severity: ConformanceSeverity;
 }
-interface NormalizedWarning {
+
+type ProfileName = "base" | "equipped" | "illustrated" | "lite" | "prepped" | "scalable" | "timed" | "minimal" | "core";
+interface NormalizedError {
     path: string;
     message: string;
+    keyword?: string;
 }
+/**
+ * Validation modes for recipe validation.
+ * - "schema": JSON Schema only
+ * - "full": JSON Schema + semantic conformance checks
+ */
+type ValidateMode = "schema" | "full";
 interface ValidateOptions {
     profile?: ProfileName;
     schema?: string;
     collectAllErrors?: boolean;
+    mode?: ValidateMode;
+    includeNormalized?: boolean;
 }
-interface ValidationResult {
-    valid: boolean;
-    errors: NormalizedError[];
-    warnings: NormalizedWarning[];
-    normalized?: Recipe;
+/**
+ * Result payload for recipe validation. Schema validation always runs first;
+ * conformance issues are only included when running in full mode.
+ */
+interface ValidateResult {
+    ok: boolean;
+    schemaErrors: NormalizedError[];
+    conformanceIssues: ConformanceIssue[];
+    warnings: string[];
+    normalizedRecipe?: Recipe;
 }
-declare function validateRecipe(input: any, options?: ValidateOptions): ValidationResult;
+/**
+ * Legacy validateRecipe function - now uses the new validateRecipeSchema internally
+ * but maintains backward compatibility with profile/stack-based validation
+ * Also includes semantic conformance validation.
+ */
+/**
+ * Validates a recipe with explicit validation modes.
+ * - mode="schema": JSON Schema only
+ * - mode="full": schema + semantic conformance (only if schema passes)
+ */
+declare function validateRecipe(input: any, options?: ValidateOptions): ValidateResult;
 declare function detectProfiles(recipe: any): ProfileName[];
 
 declare function fromSchemaOrg(input: unknown): Recipe | null;
 
+interface NormalizationResult {
+    recipe: Recipe;
+    warnings: string[];
+}
+/**
+ * Normalizes a recipe input to the current spec format:
+ * - Rejects inputs with legacy field (unsupported)
+ * - Converts legacy `stacks` array format to map format
+ * - Ensures `stacks` exists even if empty
+ * - Preserves existing `stacks` map format
+ *
+ * @param input - Raw recipe input (may have legacy formats)
+ * @returns Normalized recipe with warnings for any issues encountered
+ * @throws Error if input contains legacy field
+ */
+declare function normalizeRecipe(input: unknown): NormalizationResult;
+
 interface SchemaOrgRecipe$1 {
     '@context'?: string | Array<string | Record<string, unknown>> | Record<string, unknown>;
     '@type'?: string | string[];
@@ -352,8 +398,8 @@ interface NutritionInformation {
  * Convert a Soustack recipe to Schema.org JSON-LD format.
  *
  * BREAKING CHANGE in v0.3.0: This function now targets the "minimal" profile
- * and only includes modules that are schemaOrgMappable (as defined in the
- * modules registry). Non-mappable modules (e.g., nutrition@1, schedule@1)
+ * and only includes stacks that are schemaOrgMappable (as defined in the
+ * stacks registry). Non-mappable stacks (e.g., nutrition@1, schedule@1)
  * are excluded from the conversion.
  */
 declare function toSchemaOrg(recipe: Recipe): SchemaOrgRecipe$1;
@@ -448,4 +494,4 @@ interface MiseEnPlacePlan {
 }
 declare function miseEnPlace(ingredients: Ingredient[]): MiseEnPlacePlan;
 
-export { type Alternative, type AttributionModule, type ConvertMode, type ConvertTarget, type ConvertedLineItem, type Equipment, type FrozenStorageMethod, type Ingredient$1 as Ingredient, type IngredientItem, type IngredientSubsection, type Instruction, type InstructionItem, type InstructionSubsection, type LineItem, type MakeAheadComponent, type MediaModule, type Ingredient as MiseEnPlaceIngredient, type MiseEnPlacePlan, type Quantity as MiseEnPlaceQuantity, type MiseEnPlaceTask, MissingEquivalencyError, type NutritionFacts, type ParsedIngredient, type ParsedYield, type Quantity$1 as Quantity, type Recipe, type RoundMode, SOUSTACK_SPEC_VERSION, type Scaling, type ScalingBakersPercentage, type ScalingBase, type ScalingDiscrete, type ScalingFixed, type ScalingLinear, type ScalingProportional, type SimpleTime, type Source, type SoustackInstruction, type SoustackRecipe, type StepTiming, type Storage, type StorageMethod, type StructuredTime, type Substitution, type TaxonomyModule, type Time, type TimesModule, UnknownUnitError, UnsupportedConversionError, type Yield, convertLineItemToMetric, detectProfiles, extractSchemaOrgRecipeFromHTML, fromSchemaOrg, miseEnPlace, scaleRecipe, toSchemaOrg, validateRecipe };
+export { type Alternative, type AttributionModule, type ConvertMode, type ConvertTarget, type ConvertedLineItem, type Equipment, type FrozenStorageMethod, type Ingredient$1 as Ingredient, type IngredientItem, type IngredientSubsection, type Instruction, type InstructionItem, type InstructionSubsection, type LineItem, type MakeAheadComponent, type MediaModule, type Ingredient as MiseEnPlaceIngredient, type MiseEnPlacePlan, type Quantity as MiseEnPlaceQuantity, type MiseEnPlaceTask, MissingEquivalencyError, type NormalizationResult, type NutritionFacts, type ParsedIngredient, type ParsedYield, type Quantity$1 as Quantity, type Recipe, type RoundMode, SOUSTACK_SPEC_VERSION, type Scaling, type ScalingBakersPercentage, type ScalingBase, type ScalingDiscrete, type ScalingFixed, type ScalingLinear, type ScalingProportional, type SimpleTime, type Source, type SoustackInstruction, type SoustackRecipe, type StepTiming, type Storage, type StorageMethod, type StructuredTime, type Substitution, type TaxonomyModule, type Time, type TimesModule, UnknownUnitError, UnsupportedConversionError, type ValidateMode, type ValidateResult, type Yield, convertLineItemToMetric, detectProfiles, extractSchemaOrgRecipeFromHTML, fromSchemaOrg, miseEnPlace, normalizeRecipe, scaleRecipe, toSchemaOrg, validateRecipe };