@pantry-pilot/pantry-pilot-api 1.0.3 → 1.4.0

package/dist/index.d.ts

@@ -1,8 +1,71 @@
 import type { QueryKey, UseMutationOptions, UseMutationResult, UseQueryOptions, UseQueryResult } from '@tanstack/react-query';
 import type { AxiosError, AxiosRequestConfig, AxiosResponse } from 'axios';
+export type ActivePlanSlotRecipeId = number | null;
+export type ActivePlanSlotCatalogRecipeId = number | null;
+export type ActivePlanSlotTitle = string | null;
+export type ActivePlanSlotServingsOverride = number | null;
+export type ActivePlanSlotNotes = string | null;
+/**
+ * One of today's slots in the dashboard's active-plan widget (§5.3).
+ */
+export interface ActivePlanSlot {
+    id: number;
+    day_index: number;
+    meal_type: MealTypeEnum;
+    recipe_id?: ActivePlanSlotRecipeId;
+    catalog_recipe_id?: ActivePlanSlotCatalogRecipeId;
+    title?: ActivePlanSlotTitle;
+    servings_override?: ActivePlanSlotServingsOverride;
+    notes?: ActivePlanSlotNotes;
+    position?: number;
+    skip?: boolean;
+}
+export type ActivePlanSummaryWeekStart = string | null;
+export type ActivePlanSummaryDurationWeeks = number | null;
+export type ActivePlanSummaryDayIndex = number | null;
+/**
+ * The household's active plan + today's slots. ``day_index`` is today's
+index within the plan week (null when the plan is not dated / today is
+outside it, in which case ``slots`` is empty).
+ */
+export interface ActivePlanSummary {
+    plan_id: number;
+    name: string;
+    kind: MealPlanKindEnum;
+    status: MealPlanStatusEnum;
+    week_start?: ActivePlanSummaryWeekStart;
+    duration_weeks?: ActivePlanSummaryDurationWeeks;
+    day_index?: ActivePlanSummaryDayIndex;
+    slots?: ActivePlanSlot[];
+}
+export type AddMissingRequestShoppingListId = number | null;
+export interface AddMissingRequest {
+    shopping_list_id?: AddMissingRequestShoppingListId;
+}
+export interface AddMissingResponse {
+    shopping_list_id: number;
+    added?: ShoppingListItemResponse[];
+    skipped?: string[];
+}
+export interface BarcodeRequest {
+    /**
+     * UPC/EAN barcode (8-14 digits)
+     * @pattern ^\d{8,14}$
+     */
+    barcode: string;
+}
+export type BodyAddRatingPhotoRatingsTargetTypeTargetIdPhotosPostStepIndex = number | null;
+export type BodyAddRatingPhotoRatingsTargetTypeTargetIdPhotosPostCaption = string | null;
+export interface BodyAddRatingPhotoRatingsTargetTypeTargetIdPhotosPost {
+    file: string;
+    step_index?: BodyAddRatingPhotoRatingsTargetTypeTargetIdPhotosPostStepIndex;
+    caption?: BodyAddRatingPhotoRatingsTargetTypeTargetIdPhotosPostCaption;
+}
 export type BodyCreatePantryItemPantryItemsPostExpirationDate = string | null;
 export type BodyCreatePantryItemPantryItemsPostLocation = LocationEnum | null;
+export type BodyCreatePantryItemPantryItemsPostLocationId = number | null;
 export type BodyCreatePantryItemPantryItemsPostNotes = string | null;
+export type BodyCreatePantryItemPantryItemsPostIngredientId = number | null;
 export type BodyCreatePantryItemPantryItemsPostImage = string | null;
 export interface BodyCreatePantryItemPantryItemsPost {
     name: string;
@@ -11,7 +74,9 @@ export interface BodyCreatePantryItemPantryItemsPost {
     quantity_unit: QuantityUnitEnum;
     expiration_date?: BodyCreatePantryItemPantryItemsPostExpirationDate;
     location?: BodyCreatePantryItemPantryItemsPostLocation;
+    location_id?: BodyCreatePantryItemPantryItemsPostLocationId;
     notes?: BodyCreatePantryItemPantryItemsPostNotes;
+    ingredient_id?: BodyCreatePantryItemPantryItemsPostIngredientId;
     image?: BodyCreatePantryItemPantryItemsPostImage;
 }
 export interface BodyCreateRecipeRecipesPost {
@@ -24,12 +89,19 @@ export interface BodyCreateRecipeRecipesPost {
     servings?: number;
     image?: string;
 }
+export interface BodyRecognizeItemsAiRecognizeItemsPost {
+    image: string;
+}
+export interface BodyRecognizeReceiptAiRecognizeReceiptPost {
+    image: string;
+}
 export type BodyUpdatePantryItemPantryItemsItemIdPutName = string | null;
 export type BodyUpdatePantryItemPantryItemsItemIdPutItemType = ItemTypeEnum | null;
 export type BodyUpdatePantryItemPantryItemsItemIdPutQuantity = number | null;
 export type BodyUpdatePantryItemPantryItemsItemIdPutQuantityUnit = QuantityUnitEnum | null;
 export type BodyUpdatePantryItemPantryItemsItemIdPutExpirationDate = string | null;
 export type BodyUpdatePantryItemPantryItemsItemIdPutLocation = LocationEnum | null;
+export type BodyUpdatePantryItemPantryItemsItemIdPutLocationId = number | null;
 export type BodyUpdatePantryItemPantryItemsItemIdPutNotes = string | null;
 export type BodyUpdatePantryItemPantryItemsItemIdPutImage = string | null;
 export type BodyUpdatePantryItemPantryItemsItemIdPutClearImage = string | null;
@@ -40,6 +112,7 @@ export interface BodyUpdatePantryItemPantryItemsItemIdPut {
     quantity_unit?: BodyUpdatePantryItemPantryItemsItemIdPutQuantityUnit;
     expiration_date?: BodyUpdatePantryItemPantryItemsItemIdPutExpirationDate;
     location?: BodyUpdatePantryItemPantryItemsItemIdPutLocation;
+    location_id?: BodyUpdatePantryItemPantryItemsItemIdPutLocationId;
     notes?: BodyUpdatePantryItemPantryItemsItemIdPutNotes;
     image?: BodyUpdatePantryItemPantryItemsItemIdPutImage;
     clear_image?: BodyUpdatePantryItemPantryItemsItemIdPutClearImage;
@@ -57,6 +130,144 @@ export interface BodyUpdateRecipeRecipesRecipeIdPut {
     image?: string;
     clear_image?: BodyUpdateRecipeRecipesRecipeIdPutClearImage;
 }
+export interface BulkItemError {
+    code: string;
+    detail: string;
+}
+export type BulkItemFailureClientRef = string | null;
+export interface BulkItemFailure {
+    index: number;
+    client_ref?: BulkItemFailureClientRef;
+    error: BulkItemError;
+}
+export type BulkItemSuccessClientRef = string | null;
+export interface BulkItemSuccess {
+    index: number;
+    id: number;
+    client_ref?: BulkItemSuccessClientRef;
+    status: string;
+}
+export type BulkMode = typeof BulkMode[keyof typeof BulkMode];
+export declare const BulkMode: {
+    readonly best_effort: "best_effort";
+    readonly atomic: "atomic";
+};
+export interface BulkResponse {
+    succeeded?: BulkItemSuccess[];
+    failed?: BulkItemFailure[];
+}
+export type CatalogIngredientDetailDefaultUnit = QuantityUnitEnum | null;
+export type CatalogIngredientDetailShelfLifeDays = number | null;
+export type CatalogIngredientDetailFdcId = number | null;
+export interface CatalogIngredientDetail {
+    id: number;
+    name: string;
+    normalized_name: string;
+    category: ItemTypeEnum;
+    default_unit?: CatalogIngredientDetailDefaultUnit;
+    shelf_life_days?: CatalogIngredientDetailShelfLifeDays;
+    fdc_id?: CatalogIngredientDetailFdcId;
+    aliases?: string[];
+    substitutions?: CatalogSubstitutionOut[];
+}
+export type CatalogIngredientSummaryDefaultUnit = QuantityUnitEnum | null;
+export type CatalogIngredientSummaryShelfLifeDays = number | null;
+export type CatalogIngredientSummaryFdcId = number | null;
+export interface CatalogIngredientSummary {
+    id: number;
+    name: string;
+    normalized_name: string;
+    category: ItemTypeEnum;
+    default_unit?: CatalogIngredientSummaryDefaultUnit;
+    shelf_life_days?: CatalogIngredientSummaryShelfLifeDays;
+    fdc_id?: CatalogIngredientSummaryFdcId;
+}
+export type CatalogRecipeDetailSourceId = string | null;
+export type CatalogRecipeDetailDescription = string | null;
+export type CatalogRecipeDetailServings = number | null;
+export type CatalogRecipeDetailPrepTime = number | null;
+export type CatalogRecipeDetailCookTime = number | null;
+export type CatalogRecipeDetailImageUrl = string | null;
+export type CatalogRecipeDetailQualityScore = number | null;
+export interface CatalogRecipeDetail {
+    id: number;
+    source: CatalogSourceEnum;
+    source_id?: CatalogRecipeDetailSourceId;
+    title: string;
+    description?: CatalogRecipeDetailDescription;
+    servings?: CatalogRecipeDetailServings;
+    prep_time?: CatalogRecipeDetailPrepTime;
+    cook_time?: CatalogRecipeDetailCookTime;
+    image_url?: CatalogRecipeDetailImageUrl;
+    quality_score?: CatalogRecipeDetailQualityScore;
+    tags?: string[];
+    instructions?: string[];
+    ingredients?: CatalogRecipeIngredientOut[];
+}
+export type CatalogRecipeIngredientOutIngredientId = number | null;
+export type CatalogRecipeIngredientOutIngredientName = string | null;
+export type CatalogRecipeIngredientOutQuantity = number | null;
+export type CatalogRecipeIngredientOutUnit = string | null;
+export interface CatalogRecipeIngredientOut {
+    ingredient_id?: CatalogRecipeIngredientOutIngredientId;
+    ingredient_name?: CatalogRecipeIngredientOutIngredientName;
+    raw_text: string;
+    quantity?: CatalogRecipeIngredientOutQuantity;
+    unit?: CatalogRecipeIngredientOutUnit;
+    optional?: boolean;
+    position?: number;
+}
+export type CatalogRecipeSummarySourceId = string | null;
+export type CatalogRecipeSummaryDescription = string | null;
+export type CatalogRecipeSummaryServings = number | null;
+export type CatalogRecipeSummaryPrepTime = number | null;
+export type CatalogRecipeSummaryCookTime = number | null;
+export type CatalogRecipeSummaryImageUrl = string | null;
+export type CatalogRecipeSummaryQualityScore = number | null;
+export interface CatalogRecipeSummary {
+    id: number;
+    source: CatalogSourceEnum;
+    source_id?: CatalogRecipeSummarySourceId;
+    title: string;
+    description?: CatalogRecipeSummaryDescription;
+    servings?: CatalogRecipeSummaryServings;
+    prep_time?: CatalogRecipeSummaryPrepTime;
+    cook_time?: CatalogRecipeSummaryCookTime;
+    image_url?: CatalogRecipeSummaryImageUrl;
+    quality_score?: CatalogRecipeSummaryQualityScore;
+    tags?: string[];
+}
+export type CatalogSourceEnum = typeof CatalogSourceEnum[keyof typeof CatalogSourceEnum];
+export declare const CatalogSourceEnum: {
+    readonly curated: "curated";
+    readonly themealdb: "themealdb";
+    readonly recipenlg: "recipenlg";
+    readonly user: "user";
+    readonly generated: "generated";
+};
+export type CatalogSubstitutionOutRatio = number | null;
+export type CatalogSubstitutionOutNote = string | null;
+export interface CatalogSubstitutionOut {
+    ingredient_id: number;
+    name: string;
+    ratio?: CatalogSubstitutionOutRatio;
+    note?: CatalogSubstitutionOutNote;
+    context?: string;
+}
+export interface CatalogTagOut {
+    id: number;
+    kind: TagKindEnum;
+    name: string;
+}
+export interface ConsumeRequest {
+    /** */
+    quantity: number;
+}
+export type ConsumeResponseItem = PantryItemResponse | null;
+export interface ConsumeResponse {
+    deleted: boolean;
+    item?: ConsumeResponseItem;
+}
 export type CuisineTypeEnum = typeof CuisineTypeEnum[keyof typeof CuisineTypeEnum];
 export declare const CuisineTypeEnum: {
     readonly italian: "italian";
@@ -70,9 +281,237 @@ export declare const CuisineTypeEnum: {
     readonly american: "american";
     readonly other: "other";
 };
+export type DashboardSummaryResponseLowStockNote = string | null;
+export type DashboardSummaryResponseActivePlan = ActivePlanSummary | null;
+/**
+ * One aggregate call for the app home screen, household-scoped.
+
+The shape is frozen: P2 filled ``suggested_recipes`` with the top-3
+coverage suggestions; P3 fills ``active_plan`` with the household's
+active meal plan.
+ */
+export interface DashboardSummaryResponse {
+    expired_count: number;
+    expiring_soon: PantryItemResponse[];
+    low_stock: PantryItemResponse[];
+    low_stock_note?: DashboardSummaryResponseLowStockNote;
+    recent_events: InventoryEventResponse[];
+    active_plan?: DashboardSummaryResponseActivePlan;
+    suggested_recipes?: RecipeSuggestion[];
+}
+export type DiscoverySortEnum = typeof DiscoverySortEnum[keyof typeof DiscoverySortEnum];
+export declare const DiscoverySortEnum: {
+    readonly recent: "recent";
+    readonly top_rated: "top_rated";
+    readonly most_favorited: "most_favorited";
+};
+export type ExpiringIngredientIngredientId = number | null;
+export type ExpiringIngredientPantryItemId = number | null;
+export type ExpiringIngredientExpirationDate = string | null;
+export interface ExpiringIngredient {
+    name: string;
+    ingredient_id?: ExpiringIngredientIngredientId;
+    pantry_item_id?: ExpiringIngredientPantryItemId;
+    expiration_date?: ExpiringIngredientExpirationDate;
+}
+export type FavoriteResponseRecipeId = number | null;
+export type FavoriteResponseMealPlanId = number | null;
+export interface FavoriteResponse {
+    id: number;
+    user_id: number;
+    target_type: SocialTargetEnum;
+    recipe_id?: FavoriteResponseRecipeId;
+    meal_plan_id?: FavoriteResponseMealPlanId;
+    created_at: string;
+}
+export type GenerateRecipeRequestCuisine = string | null;
+export interface GenerateRecipeRequest {
+    /** @maxLength 500 */
+    preferences?: string;
+    cuisine?: GenerateRecipeRequestCuisine;
+    /**
+     * @minimum 1
+     * @maximum 30
+     */
+    expiry_days_threshold?: number;
+}
+export interface GoogleLogin {
+    /** @minLength 1 */
+    id_token: string;
+}
+export type GroundedScaledIngredientQuantity = number | null;
+export type GroundedScaledIngredientUnit = string | null;
+export interface GroundedScaledIngredient {
+    /**
+     * @minLength 1
+     * @maxLength 200
+     */
+    name: string;
+    quantity?: GroundedScaledIngredientQuantity;
+    unit?: GroundedScaledIngredientUnit;
+    is_in_pantry?: boolean;
+}
+/**
+ * Numeric id of a candidate catalog recipe, or null for a novel generated recipe
+ */
+export type GroundedSuggestionCatalogRecipeId = number | null;
+/**
+ * One LLM adaptation: either a catalog candidate (by id) or — only when
+every candidate's coverage is below 50% — one novel recipe (id null).
+ */
+export interface GroundedSuggestion {
+    /** Numeric id of a candidate catalog recipe, or null for a novel generated recipe */
+    catalog_recipe_id?: GroundedSuggestionCatalogRecipeId;
+    /**
+     * @minLength 1
+     * @maxLength 300
+     */
+    title: string;
+    /**
+     * @maximum 50
+     */
+    servings: number;
+    scaled_ingredients?: GroundedScaledIngredient[];
+    missing?: string[];
+    substitutions_applied?: string[];
+    uses_expiring?: string[];
+    /**
+     * @minLength 1
+     * @maxLength 500
+     */
+    rationale: string;
+}
 export interface HTTPValidationError {
     detail?: ValidationError[];
 }
+export interface HouseholdMemberOut {
+    user_id: number;
+    username: string;
+    role: HouseholdRoleEnum;
+}
+export type HouseholdResponseSettings = {
+    [key: string]: unknown;
+};
+/**
+ * The caller's household. ``settings`` is the raw stored JSONB document
+(pass-through dict): reads must stay robust for legacy payloads (e.g.
+the M1/M2 default ``week_start_day: "monday"`` string), while writes are
+strictly validated through HouseholdSettings on PATCH.
+ */
+export interface HouseholdResponse {
+    id: number;
+    name: string;
+    settings: HouseholdResponseSettings;
+    members: HouseholdMemberOut[];
+    created_at: string;
+}
+export type HouseholdRoleEnum = typeof HouseholdRoleEnum[keyof typeof HouseholdRoleEnum];
+export declare const HouseholdRoleEnum: {
+    readonly owner: "owner";
+    readonly member: "member";
+};
+export type HouseholdSettingsDefaultServings = number | null;
+export type HouseholdSettingsDietaryPrefs = string[] | null;
+export type HouseholdSettingsExpiryAlertDays = number | null;
+export type HouseholdSettingsWeekStartDay = number | null;
+export type HouseholdSettingsLowStockThresholdsAnyOf = {
+    [key: string]: unknown;
+};
+export type HouseholdSettingsLowStockThresholds = HouseholdSettingsLowStockThresholdsAnyOf | null;
+/**
+ * Validated settings payload for PATCH /household/.
+
+Every field is optional so partial patches merge into the stored JSONB
+settings document; unset fields are left untouched. Unknown keys are
+REJECTED (extra="forbid") so client typos fail loudly with a 422
+instead of silently no-oping.
+ */
+export interface HouseholdSettings {
+    default_servings?: HouseholdSettingsDefaultServings;
+    dietary_prefs?: HouseholdSettingsDietaryPrefs;
+    expiry_alert_days?: HouseholdSettingsExpiryAlertDays;
+    week_start_day?: HouseholdSettingsWeekStartDay;
+    low_stock_thresholds?: HouseholdSettingsLowStockThresholds;
+}
+export type HouseholdUpdateName = string | null;
+export type HouseholdUpdateSettings = HouseholdSettings | null;
+/**
+ * PATCH body for /household/ — both fields optional (partial update).
+ */
+export interface HouseholdUpdate {
+    name?: HouseholdUpdateName;
+    settings?: HouseholdUpdateSettings;
+}
+export type IngredientAutocompleteItemIngredientId = number | null;
+export type IngredientAutocompleteItemCategory = ItemTypeEnum | null;
+export type IngredientAutocompleteItemMatch = typeof IngredientAutocompleteItemMatch[keyof typeof IngredientAutocompleteItemMatch];
+export declare const IngredientAutocompleteItemMatch: {
+    readonly prefix: "prefix";
+    readonly alias: "alias";
+    readonly fuzzy: "fuzzy";
+    readonly history: "history";
+};
+export type IngredientAutocompleteItemSource = typeof IngredientAutocompleteItemSource[keyof typeof IngredientAutocompleteItemSource];
+export declare const IngredientAutocompleteItemSource: {
+    readonly catalog: "catalog";
+    readonly history: "history";
+    readonly popular: "popular";
+};
+export type IngredientAutocompleteItemUsageCount = number | null;
+/**
+ * One ranked autocomplete suggestion (GET /ingredients/autocomplete).
+
+``ingredient_id`` is the canonical catalog link: always set for catalog
+rows (that's how the client links a pantry item / recipe ingredient to the
+canonical ingredient); NULL for household-history names with no catalog
+link (the client can offer "create new"). ``source`` is the provenance:
+your own past (history), other users' past (popular), or the day-one
+bootstrap seed (catalog).
+ */
+export interface IngredientAutocompleteItem {
+    ingredient_id?: IngredientAutocompleteItemIngredientId;
+    name: string;
+    category?: IngredientAutocompleteItemCategory;
+    match: IngredientAutocompleteItemMatch;
+    source: IngredientAutocompleteItemSource;
+    usage_count?: IngredientAutocompleteItemUsageCount;
+}
+export type InventoryEventKindEnum = typeof InventoryEventKindEnum[keyof typeof InventoryEventKindEnum];
+export declare const InventoryEventKindEnum: {
+    readonly added: "added";
+    readonly consumed: "consumed";
+    readonly adjusted: "adjusted";
+    readonly discarded: "discarded";
+    readonly expired: "expired";
+    readonly restocked: "restocked";
+};
+export type InventoryEventResponsePantryItemId = number | null;
+export type InventoryEventResponseUserId = number | null;
+export type InventoryEventResponseQuantityDelta = number | null;
+export type InventoryEventResponseMetadataAnyOf = {
+    [key: string]: unknown;
+};
+export type InventoryEventResponseMetadata = InventoryEventResponseMetadataAnyOf | null;
+export interface InventoryEventResponse {
+    id: number;
+    household_id: number;
+    pantry_item_id?: InventoryEventResponsePantryItemId;
+    user_id?: InventoryEventResponseUserId;
+    kind: InventoryEventKindEnum;
+    quantity_delta?: InventoryEventResponseQuantityDelta;
+    source: InventoryEventSourceEnum;
+    metadata?: InventoryEventResponseMetadata;
+    created_at: string;
+}
+export type InventoryEventSourceEnum = typeof InventoryEventSourceEnum[keyof typeof InventoryEventSourceEnum];
+export declare const InventoryEventSourceEnum: {
+    readonly manual: "manual";
+    readonly vision: "vision";
+    readonly barcode: "barcode";
+    readonly receipt: "receipt";
+    readonly plan: "plan";
+    readonly system: "system";
+};
 export type ItemTypeEnum = typeof ItemTypeEnum[keyof typeof ItemTypeEnum];
 export declare const ItemTypeEnum: {
     readonly spices: "spices";
@@ -94,6 +533,174 @@ export declare const LocationEnum: {
     readonly pantry: "pantry";
     readonly other: "other";
 };
+export type MealPlanCreateWeekStart = string | null;
+export type MealPlanCreateDurationWeeks = number | null;
+export type MealPlanCreateTemplateId = number | null;
+/**
+ * Create an empty plan, or copy one from a template/preset (§5.5).
+ */
+export interface MealPlanCreate {
+    /**
+     * @minLength 1
+     * @maxLength 200
+     */
+    name: string;
+    kind?: MealPlanKindEnum;
+    week_start?: MealPlanCreateWeekStart;
+    duration_weeks?: MealPlanCreateDurationWeeks;
+    is_template?: boolean;
+    visibility?: VisibilityEnum;
+    template_id?: MealPlanCreateTemplateId;
+}
+export type MealPlanDetailResponseHouseholdId = number | null;
+export type MealPlanDetailResponseCreatedByUserId = number | null;
+export type MealPlanDetailResponseWeekStart = string | null;
+export type MealPlanDetailResponseDurationWeeks = number | null;
+export type MealPlanDetailResponseForkedFromPlanId = number | null;
+export interface MealPlanDetailResponse {
+    id: number;
+    household_id?: MealPlanDetailResponseHouseholdId;
+    created_by_user_id?: MealPlanDetailResponseCreatedByUserId;
+    name: string;
+    kind: MealPlanKindEnum;
+    status: MealPlanStatusEnum;
+    is_template?: boolean;
+    is_preset?: boolean;
+    week_start?: MealPlanDetailResponseWeekStart;
+    duration_weeks?: MealPlanDetailResponseDurationWeeks;
+    visibility: VisibilityEnum;
+    source: MealPlanSourceEnum;
+    forked_from_plan_id?: MealPlanDetailResponseForkedFromPlanId;
+    slot_count?: number;
+    created_at: string;
+    updated_at: string;
+    slots?: MealPlanSlotResponse[];
+}
+export type MealPlanGenerateResponseHouseholdId = number | null;
+export type MealPlanGenerateResponseCreatedByUserId = number | null;
+export type MealPlanGenerateResponseWeekStart = string | null;
+export type MealPlanGenerateResponseDurationWeeks = number | null;
+export type MealPlanGenerateResponseForkedFromPlanId = number | null;
+export interface MealPlanGenerateResponse {
+    id: number;
+    household_id?: MealPlanGenerateResponseHouseholdId;
+    created_by_user_id?: MealPlanGenerateResponseCreatedByUserId;
+    name: string;
+    kind: MealPlanKindEnum;
+    status: MealPlanStatusEnum;
+    is_template?: boolean;
+    is_preset?: boolean;
+    week_start?: MealPlanGenerateResponseWeekStart;
+    duration_weeks?: MealPlanGenerateResponseDurationWeeks;
+    visibility: VisibilityEnum;
+    source: MealPlanSourceEnum;
+    forked_from_plan_id?: MealPlanGenerateResponseForkedFromPlanId;
+    slot_count?: number;
+    created_at: string;
+    updated_at: string;
+    slots?: MealPlanSlotResponse[];
+    metadata: PlanGenerateMetadata;
+}
+export type MealPlanKindEnum = typeof MealPlanKindEnum[keyof typeof MealPlanKindEnum];
+export declare const MealPlanKindEnum: {
+    readonly weekly: "weekly";
+    readonly diet: "diet";
+};
+export interface MealPlanRequest {
+    /**
+     * @minimum 1
+     * @maximum 7
+     */
+    days?: number;
+    /** @maxLength 500 */
+    preferences?: string;
+}
+export type MealPlanResponseHouseholdId = number | null;
+export type MealPlanResponseCreatedByUserId = number | null;
+export type MealPlanResponseWeekStart = string | null;
+export type MealPlanResponseDurationWeeks = number | null;
+export type MealPlanResponseForkedFromPlanId = number | null;
+export interface MealPlanResponse {
+    id: number;
+    household_id?: MealPlanResponseHouseholdId;
+    created_by_user_id?: MealPlanResponseCreatedByUserId;
+    name: string;
+    kind: MealPlanKindEnum;
+    status: MealPlanStatusEnum;
+    is_template?: boolean;
+    is_preset?: boolean;
+    week_start?: MealPlanResponseWeekStart;
+    duration_weeks?: MealPlanResponseDurationWeeks;
+    visibility: VisibilityEnum;
+    source: MealPlanSourceEnum;
+    forked_from_plan_id?: MealPlanResponseForkedFromPlanId;
+    slot_count?: number;
+    created_at: string;
+    updated_at: string;
+}
+export type MealPlanSlotResponseRecipeId = number | null;
+export type MealPlanSlotResponseCatalogRecipeId = number | null;
+export type MealPlanSlotResponseTitle = string | null;
+export type MealPlanSlotResponseServingsOverride = number | null;
+export type MealPlanSlotResponseNotes = string | null;
+export interface MealPlanSlotResponse {
+    id: number;
+    plan_id: number;
+    day_index: number;
+    meal_type: MealTypeEnum;
+    recipe_id?: MealPlanSlotResponseRecipeId;
+    catalog_recipe_id?: MealPlanSlotResponseCatalogRecipeId;
+    title?: MealPlanSlotResponseTitle;
+    servings_override?: MealPlanSlotResponseServingsOverride;
+    notes?: MealPlanSlotResponseNotes;
+    position?: number;
+    skip?: boolean;
+    created_at: string;
+}
+export type MealPlanSourceEnum = typeof MealPlanSourceEnum[keyof typeof MealPlanSourceEnum];
+export declare const MealPlanSourceEnum: {
+    readonly manual: "manual";
+    readonly generated: "generated";
+    readonly preset: "preset";
+    readonly forked: "forked";
+};
+export type MealPlanStatusEnum = typeof MealPlanStatusEnum[keyof typeof MealPlanStatusEnum];
+export declare const MealPlanStatusEnum: {
+    readonly draft: "draft";
+    readonly active: "active";
+    readonly archived: "archived";
+};
+export type MealPlanUpdateName = string | null;
+export type MealPlanUpdateStatus = MealPlanStatusEnum | null;
+export type MealPlanUpdateWeekStart = string | null;
+export type MealPlanUpdateDurationWeeks = number | null;
+export type MealPlanUpdateVisibility = VisibilityEnum | null;
+export interface MealPlanUpdate {
+    name?: MealPlanUpdateName;
+    status?: MealPlanUpdateStatus;
+    week_start?: MealPlanUpdateWeekStart;
+    duration_weeks?: MealPlanUpdateDurationWeeks;
+    visibility?: MealPlanUpdateVisibility;
+}
+export type MealTypeEnum = typeof MealTypeEnum[keyof typeof MealTypeEnum];
+export declare const MealTypeEnum: {
+    readonly breakfast: "breakfast";
+    readonly lunch: "lunch";
+    readonly dinner: "dinner";
+    readonly snack: "snack";
+};
+export interface MessageResponse {
+    message: string;
+}
+export type MissingIngredientIngredientId = number | null;
+export type MissingIngredientQuantity = number | null;
+export type MissingIngredientUnit = string | null;
+export interface MissingIngredient {
+    name: string;
+    ingredient_id?: MissingIngredientIngredientId;
+    quantity?: MissingIngredientQuantity;
+    unit?: MissingIngredientUnit;
+}
 export type OrderByEnum = typeof OrderByEnum[keyof typeof OrderByEnum];
 export declare const OrderByEnum: {
     readonly name: "name";
@@ -105,10 +712,80 @@ export declare const OrderEnum: {
     readonly asc: "asc";
     readonly desc: "desc";
 };
+export type PantryItemBulkCreateItemClientRef = string | null;
+export type PantryItemBulkCreateItemExpirationDate = string | null;
+export type PantryItemBulkCreateItemLocationId = number | null;
+export type PantryItemBulkCreateItemNotes = string | null;
+export type PantryItemBulkCreateItemSource = InventoryEventSourceEnum | null;
+export type PantryItemBulkCreateItemIngredientId = number | null;
+/**
+ * One bulk-create row. Only type-level validation here — per-item business
+validation happens in the service so best_effort can collect failures.
+ */
+export interface PantryItemBulkCreateItem {
+    client_ref?: PantryItemBulkCreateItemClientRef;
+    name: string;
+    item_type: ItemTypeEnum;
+    quantity: number;
+    quantity_unit: QuantityUnitEnum;
+    expiration_date?: PantryItemBulkCreateItemExpirationDate;
+    location_id?: PantryItemBulkCreateItemLocationId;
+    notes?: PantryItemBulkCreateItemNotes;
+    source?: PantryItemBulkCreateItemSource;
+    ingredient_id?: PantryItemBulkCreateItemIngredientId;
+}
+export interface PantryItemBulkCreateRequest {
+    mode?: BulkMode;
+    /**
+     * @minItems 1
+     * @maxItems 100
+     */
+    items: PantryItemBulkCreateItem[];
+}
+export interface PantryItemBulkDeleteRequest {
+    mode?: BulkMode;
+    /**
+     * @minItems 1
+     * @maxItems 100
+     */
+    ids: number[];
+}
+export type PantryItemBulkUpdateItemClientRef = string | null;
+export type PantryItemBulkUpdateItemName = string | null;
+export type PantryItemBulkUpdateItemItemType = ItemTypeEnum | null;
+export type PantryItemBulkUpdateItemQuantity = number | null;
+export type PantryItemBulkUpdateItemQuantityUnit = QuantityUnitEnum | null;
+export type PantryItemBulkUpdateItemExpirationDate = string | null;
+export type PantryItemBulkUpdateItemLocationId = number | null;
+export type PantryItemBulkUpdateItemNotes = string | null;
+export interface PantryItemBulkUpdateItem {
+    id: number;
+    client_ref?: PantryItemBulkUpdateItemClientRef;
+    name?: PantryItemBulkUpdateItemName;
+    item_type?: PantryItemBulkUpdateItemItemType;
+    quantity?: PantryItemBulkUpdateItemQuantity;
+    quantity_unit?: PantryItemBulkUpdateItemQuantityUnit;
+    expiration_date?: PantryItemBulkUpdateItemExpirationDate;
+    location_id?: PantryItemBulkUpdateItemLocationId;
+    notes?: PantryItemBulkUpdateItemNotes;
+}
+export interface PantryItemBulkUpdateRequest {
+    mode?: BulkMode;
+    /**
+     * @minItems 1
+     * @maxItems 100
+     */
+    items: PantryItemBulkUpdateItem[];
+}
 export type PantryItemResponseImage = string | null;
 export type PantryItemResponseExpirationDate = string | null;
 export type PantryItemResponseLocation = string | null;
 export type PantryItemResponseNotes = string | null;
+export type PantryItemResponseHouseholdId = number | null;
+export type PantryItemResponseLocationId = number | null;
+export type PantryItemResponseClientRef = string | null;
+export type PantryItemResponseStorageLocation = StorageLocationResponse | null;
+export type PantryItemResponseIngredientId = number | null;
 export interface PantryItemResponse {
     id: number;
     name: string;
@@ -122,6 +799,11 @@ export interface PantryItemResponse {
     user_id: number;
     created_at: string;
     updated_at: string;
+    household_id?: PantryItemResponseHouseholdId;
+    location_id?: PantryItemResponseLocationId;
+    client_ref?: PantryItemResponseClientRef;
+    storage_location?: PantryItemResponseStorageLocation;
+    ingredient_id?: PantryItemResponseIngredientId;
 }
 export interface PasswordChange {
     current_password: string;
@@ -131,6 +813,157 @@ export interface PasswordChange {
      */
     new_password: string;
 }
+export interface PlanGenerateMetadata {
+    provider: string;
+    model: string;
+    prompt_version: string;
+    candidates_considered: number;
+}
+export type PlanGenerateRequestServings = number | null;
+export type PlanGenerateRequestWeekStart = string | null;
+export type PlanGenerateRequestName = string | null;
+/**
+ * Agentic grounded plan generation (§9.2). The unit is one week;
+``days`` < 7 generates a partial week.
+ */
+export interface PlanGenerateRequest {
+    /**
+     * @minimum 1
+     * @maximum 7
+     */
+    days?: number;
+    /**
+     * @minItems 1
+     * @maxItems 4
+     */
+    meal_types?: MealTypeEnum[];
+    /** @maxLength 500 */
+    preferences?: string;
+    use_expiring?: boolean;
+    servings?: PlanGenerateRequestServings;
+    week_start?: PlanGenerateRequestWeekStart;
+    name?: PlanGenerateRequestName;
+    /**
+     * @minimum 1
+     * @maximum 30
+     */
+    expiry_days_threshold?: number;
+}
+export type PlanGroceryListRequestShoppingListId = number | null;
+export interface PlanGroceryListRequest {
+    shopping_list_id?: PlanGroceryListRequestShoppingListId;
+}
+export type PlanGroceryListResponseCreatedByUserId = number | null;
+export type PlanGroceryListResponseMealPlanId = number | null;
+/**
+ * The list after plan-gap derivation (§10), plus derivation stats.
+ */
+export interface PlanGroceryListResponse {
+    id: number;
+    household_id: number;
+    name: string;
+    status: ShoppingListStatusEnum;
+    source: ShoppingListSourceEnum;
+    created_by_user_id?: PlanGroceryListResponseCreatedByUserId;
+    meal_plan_id?: PlanGroceryListResponseMealPlanId;
+    item_count?: number;
+    unchecked_count?: number;
+    created_at: string;
+    items?: ShoppingListItemResponse[];
+    added_count?: number;
+    skipped?: string[];
+    have_some?: string[];
+}
+export type PlanSlotBulkItemId = number | null;
+export type PlanSlotBulkItemRecipeId = number | null;
+export type PlanSlotBulkItemCatalogRecipeId = number | null;
+export type PlanSlotBulkItemServingsOverride = number | null;
+export type PlanSlotBulkItemNotes = string | null;
+export type PlanSlotBulkItemPosition = number | null;
+/**
+ * One plan-editor cell operation (§5.5). No id -> create; id -> update
+(or delete with ``_delete=true``).
+ */
+export interface PlanSlotBulkItem {
+    id?: PlanSlotBulkItemId;
+    /**
+     * @minimum 0
+     * @maximum 6
+     */
+    day_index: number;
+    meal_type: MealTypeEnum;
+    recipe_id?: PlanSlotBulkItemRecipeId;
+    catalog_recipe_id?: PlanSlotBulkItemCatalogRecipeId;
+    servings_override?: PlanSlotBulkItemServingsOverride;
+    notes?: PlanSlotBulkItemNotes;
+    position?: PlanSlotBulkItemPosition;
+    skip?: boolean;
+    _delete?: boolean;
+}
+export interface PlanSlotBulkRequest {
+    mode?: BulkMode;
+    /**
+     * @minItems 1
+     * @maxItems 100
+     */
+    items: PlanSlotBulkItem[];
+}
+export type PresetAdoptResponseStarterList = PlanGroceryListResponse | null;
+export interface PresetAdoptResponse {
+    plan: MealPlanDetailResponse;
+    starter_list?: PresetAdoptResponseStarterList;
+}
+export type PublicPlanSummaryWeekStart = string | null;
+export type PublicPlanSummaryDurationWeeks = number | null;
+export type PublicPlanSummaryAuthor = string | null;
+export type PublicPlanSummaryForkedFromPlanId = number | null;
+export type PublicPlanSummaryRatingAvg = number | null;
+/**
+ * Discovery card for GET /plans/public.
+ */
+export interface PublicPlanSummary {
+    id: number;
+    name: string;
+    kind: MealPlanKindEnum;
+    status: MealPlanStatusEnum;
+    week_start?: PublicPlanSummaryWeekStart;
+    duration_weeks?: PublicPlanSummaryDurationWeeks;
+    slot_count?: number;
+    author?: PublicPlanSummaryAuthor;
+    forked_from_plan_id?: PublicPlanSummaryForkedFromPlanId;
+    rating_avg?: PublicPlanSummaryRatingAvg;
+    rating_count?: number;
+    favorite_count?: number;
+    created_at: string;
+    updated_at: string;
+}
+export type PublicRecipeSummaryImage = string | null;
+export type PublicRecipeSummaryPrepTime = number | null;
+export type PublicRecipeSummaryCookTime = number | null;
+export type PublicRecipeSummaryServings = number | null;
+export type PublicRecipeSummaryAuthor = string | null;
+export type PublicRecipeSummaryForkedFromRecipeId = number | null;
+export type PublicRecipeSummaryRatingAvg = number | null;
+/**
+ * Discovery card for GET /recipes/public (§5.7). Only ever built from
+visibility='public' rows — nothing private leaks through this shape.
+ */
+export interface PublicRecipeSummary {
+    id: number;
+    name: string;
+    cuisine: CuisineTypeEnum;
+    image?: PublicRecipeSummaryImage;
+    prep_time?: PublicRecipeSummaryPrepTime;
+    cook_time?: PublicRecipeSummaryCookTime;
+    servings?: PublicRecipeSummaryServings;
+    author?: PublicRecipeSummaryAuthor;
+    forked_from_recipe_id?: PublicRecipeSummaryForkedFromRecipeId;
+    rating_avg?: PublicRecipeSummaryRatingAvg;
+    rating_count?: number;
+    favorite_count?: number;
+    created_at: string;
+    updated_at: string;
+}
 export type QuantityUnitEnum = typeof QuantityUnitEnum[keyof typeof QuantityUnitEnum];
 export declare const QuantityUnitEnum: {
     readonly lbs: "lbs";
@@ -143,18 +976,57 @@ export declare const QuantityUnitEnum: {
     readonly ml: "ml";
     readonly liters: "liters";
 };
+export type RatingAggregateResponseAverage = number | null;
+export type RatingAggregateResponseMyRating = ReviewOut | null;
+/**
+ * GET /ratings/{target_type}/{id}: the aggregate plus recent reviews.
+ */
+export interface RatingAggregateResponse {
+    target_type: SocialTargetEnum;
+    target_id: number;
+    average?: RatingAggregateResponseAverage;
+    count?: number;
+    my_rating?: RatingAggregateResponseMyRating;
+    reviews?: ReviewOut[];
+}
+export type RatingPhotoResponseStepIndex = number | null;
+export type RatingPhotoResponseCaption = string | null;
+export interface RatingPhotoResponse {
+    id: number;
+    rating_id: number;
+    image: string;
+    step_index?: RatingPhotoResponseStepIndex;
+    caption?: RatingPhotoResponseCaption;
+    created_at: string;
+}
+export type RatingUpsertReview = string | null;
+export interface RatingUpsert {
+    /**
+     * @minimum 1
+     * @maximum 5
+     */
+    stars: number;
+    review?: RatingUpsertReview;
+}
 export type RecipeIngredientResponseUnit = string | null;
 export type RecipeIngredientResponsePantryItemId = number | null;
+export type RecipeIngredientResponseIngredientId = number | null;
 export interface RecipeIngredientResponse {
     name: string;
     quantity: number;
     unit?: RecipeIngredientResponseUnit;
     pantry_item_id?: RecipeIngredientResponsePantryItemId;
+    ingredient_id?: RecipeIngredientResponseIngredientId;
 }
 export type RecipeResponseImage = string | null;
 export type RecipeResponsePrepTime = number | null;
 export type RecipeResponseCookTime = number | null;
 export type RecipeResponseServings = number | null;
+export type RecipeResponseHouseholdId = number | null;
+export type RecipeResponseVisibility = VisibilityEnum | null;
+export type RecipeResponseSource = RecipeSourceEnum | null;
+export type RecipeResponseSourceCatalogRecipeId = number | null;
+export type RecipeResponseForkedFromRecipeId = number | null;
 export interface RecipeResponse {
     id: number;
     name: string;
@@ -168,46 +1040,368 @@ export interface RecipeResponse {
     prep_time?: RecipeResponsePrepTime;
     cook_time?: RecipeResponseCookTime;
     servings?: RecipeResponseServings;
+    household_id?: RecipeResponseHouseholdId;
+    visibility?: RecipeResponseVisibility;
+    source?: RecipeResponseSource;
+    source_catalog_recipe_id?: RecipeResponseSourceCatalogRecipeId;
+    forked_from_recipe_id?: RecipeResponseForkedFromRecipeId;
 }
-export interface Token {
-    access_token: string;
-    token_type: string;
-}
-export interface UserCreate {
+export type RecipeSourceEnum = typeof RecipeSourceEnum[keyof typeof RecipeSourceEnum];
+export declare const RecipeSourceEnum: {
+    readonly manual: "manual";
+    readonly generated: "generated";
+    readonly forked: "forked";
+    readonly catalog_copy: "catalog_copy";
+};
+export type RecipeSuggestionDescription = string | null;
+export type RecipeSuggestionCuisine = string | null;
+export type RecipeSuggestionImageUrl = string | null;
+export type RecipeSuggestionServings = number | null;
+export type RecipeSuggestionPrepTime = number | null;
+export type RecipeSuggestionCookTime = number | null;
+export interface RecipeSuggestion {
+    recipe_kind: string;
+    recipe_id: number;
+    title: string;
+    description?: RecipeSuggestionDescription;
+    cuisine?: RecipeSuggestionCuisine;
+    image_url?: RecipeSuggestionImageUrl;
+    servings?: RecipeSuggestionServings;
+    prep_time?: RecipeSuggestionPrepTime;
+    cook_time?: RecipeSuggestionCookTime;
     /**
-     * @minLength 3
-     * @maxLength 150
-     * @pattern ^[a-zA-Z0-9_-]+$
+     * @minimum 0
+     * @maximum 100
      */
-    username: string;
+    coverage_pct: number;
+    matched?: SuggestionIngredient[];
+    missing?: MissingIngredient[];
+    uses_expiring?: ExpiringIngredient[];
+    tags?: string[];
+}
+export interface ResendVerificationRequest {
     email: string;
+}
+export type ReviewOutUsername = string | null;
+export type ReviewOutReview = string | null;
+/**
+ * One rating as shown in the review list (D3: Google-reviews-style,
+but for recipes): stars + optional detailed comment + optional cook-along
+per-step photos.
+ */
+export interface ReviewOut {
+    id: number;
+    user_id: number;
+    username?: ReviewOutUsername;
+    stars: number;
+    review?: ReviewOutReview;
+    photos?: RatingPhotoResponse[];
+    created_at: string;
+    updated_at: string;
+}
+export interface SearchRequest {
     /**
      * @minLength 1
-     * @maxLength 100
+     * @maxLength 500
      */
-    first_name: string;
+    query: string;
+}
+export interface ShoppingListCreate {
     /**
      * @minLength 1
-     * @maxLength 100
-     */
-    last_name: string;
-    /**
-     * @minLength 8
-     * @maxLength 128
+     * @maxLength 200
      */
-    password: string;
-}
-export interface UserLogin {
-    email: string;
-    password: string;
+    name: string;
 }
-export interface UserResponse {
+export type ShoppingListDetailResponseCreatedByUserId = number | null;
+export type ShoppingListDetailResponseMealPlanId = number | null;
+export interface ShoppingListDetailResponse {
     id: number;
-    username: string;
-    email: string;
+    household_id: number;
+    name: string;
+    status: ShoppingListStatusEnum;
+    source: ShoppingListSourceEnum;
+    created_by_user_id?: ShoppingListDetailResponseCreatedByUserId;
+    meal_plan_id?: ShoppingListDetailResponseMealPlanId;
+    item_count?: number;
+    unchecked_count?: number;
+    created_at: string;
+    items?: ShoppingListItemResponse[];
+}
+export type ShoppingListExportFormat = typeof ShoppingListExportFormat[keyof typeof ShoppingListExportFormat];
+export declare const ShoppingListExportFormat: {
+    readonly text: "text";
+    readonly csv: "csv";
+    readonly deeplink: "deeplink";
+};
+export type ShoppingListExportRequestProvider = string | null;
+/**
+ * Export the unchecked items of a list. ``provider`` defaults to
+``manual`` for text/csv and to the configured deeplink provider for
+``deeplink``.
+ */
+export interface ShoppingListExportRequest {
+    format: ShoppingListExportFormat;
+    provider?: ShoppingListExportRequestProvider;
+}
+export interface ShoppingListExportResponse {
+    format: ShoppingListExportFormat;
+    payload: string;
+    provider: string;
+}
+export type ShoppingListItemBulkCreateItemClientRef = string | null;
+export type ShoppingListItemBulkCreateItemQuantity = number | null;
+export type ShoppingListItemBulkCreateItemUnit = string | null;
+export type ShoppingListItemBulkCreateItemIngredientId = number | null;
+export interface ShoppingListItemBulkCreateItem {
+    client_ref?: ShoppingListItemBulkCreateItemClientRef;
+    /**
+     * @minLength 1
+     * @maxLength 200
+     */
+    name: string;
+    quantity?: ShoppingListItemBulkCreateItemQuantity;
+    unit?: ShoppingListItemBulkCreateItemUnit;
+    ingredient_id?: ShoppingListItemBulkCreateItemIngredientId;
+    reason?: ShoppingListItemReasonEnum;
+}
+export interface ShoppingListItemBulkCreateRequest {
+    mode?: BulkMode;
+    /**
+     * @minItems 1
+     * @maxItems 100
+     */
+    items: ShoppingListItemBulkCreateItem[];
+}
+export interface ShoppingListItemBulkDeleteRequest {
+    mode?: BulkMode;
+    /**
+     * @minItems 1
+     * @maxItems 100
+     */
+    ids: number[];
+}
+export type ShoppingListItemBulkUpdateItemChecked = boolean | null;
+export type ShoppingListItemBulkUpdateItemName = string | null;
+export type ShoppingListItemBulkUpdateItemQuantity = number | null;
+export type ShoppingListItemBulkUpdateItemUnit = string | null;
+export interface ShoppingListItemBulkUpdateItem {
+    id: number;
+    checked?: ShoppingListItemBulkUpdateItemChecked;
+    name?: ShoppingListItemBulkUpdateItemName;
+    quantity?: ShoppingListItemBulkUpdateItemQuantity;
+    unit?: ShoppingListItemBulkUpdateItemUnit;
+}
+/**
+ * Bulk update/check. ``check_all=true`` is the one-tap "check everything"
+action (§5.6) and requires an empty ``items`` list.
+ */
+export interface ShoppingListItemBulkUpdateRequest {
+    mode?: BulkMode;
+    check_all?: boolean;
+    items?: ShoppingListItemBulkUpdateItem[];
+}
+export type ShoppingListItemCreateQuantity = number | null;
+export type ShoppingListItemCreateUnit = string | null;
+export type ShoppingListItemCreateIngredientId = number | null;
+export interface ShoppingListItemCreate {
+    /**
+     * @minLength 1
+     * @maxLength 200
+     */
+    name: string;
+    quantity?: ShoppingListItemCreateQuantity;
+    unit?: ShoppingListItemCreateUnit;
+    ingredient_id?: ShoppingListItemCreateIngredientId;
+}
+export type ShoppingListItemReasonEnum = typeof ShoppingListItemReasonEnum[keyof typeof ShoppingListItemReasonEnum];
+export declare const ShoppingListItemReasonEnum: {
+    readonly manual: "manual";
+    readonly missing_for_plan: "missing_for_plan";
+    readonly expiring_soon: "expiring_soon";
+    readonly low_stock: "low_stock";
+};
+export type ShoppingListItemResponseIngredientId = number | null;
+export type ShoppingListItemResponseQuantity = number | null;
+export type ShoppingListItemResponseUnit = string | null;
+export type ShoppingListItemResponseCheckedAt = string | null;
+export type ShoppingListItemResponseCheckedByUserId = number | null;
+export type ShoppingListItemResponseClientRef = string | null;
+export type ShoppingListItemResponseNote = string | null;
+export interface ShoppingListItemResponse {
+    id: number;
+    list_id: number;
+    ingredient_id?: ShoppingListItemResponseIngredientId;
+    name: string;
+    quantity?: ShoppingListItemResponseQuantity;
+    unit?: ShoppingListItemResponseUnit;
+    checked: boolean;
+    checked_at?: ShoppingListItemResponseCheckedAt;
+    checked_by_user_id?: ShoppingListItemResponseCheckedByUserId;
+    reason: ShoppingListItemReasonEnum;
+    client_ref?: ShoppingListItemResponseClientRef;
+    note?: ShoppingListItemResponseNote;
+    created_at: string;
+}
+export type ShoppingListItemUpdateChecked = boolean | null;
+export type ShoppingListItemUpdateName = string | null;
+export type ShoppingListItemUpdateQuantity = number | null;
+export type ShoppingListItemUpdateUnit = string | null;
+export interface ShoppingListItemUpdate {
+    checked?: ShoppingListItemUpdateChecked;
+    name?: ShoppingListItemUpdateName;
+    quantity?: ShoppingListItemUpdateQuantity;
+    unit?: ShoppingListItemUpdateUnit;
+}
+export type ShoppingListResponseCreatedByUserId = number | null;
+export type ShoppingListResponseMealPlanId = number | null;
+export interface ShoppingListResponse {
+    id: number;
+    household_id: number;
+    name: string;
+    status: ShoppingListStatusEnum;
+    source: ShoppingListSourceEnum;
+    created_by_user_id?: ShoppingListResponseCreatedByUserId;
+    meal_plan_id?: ShoppingListResponseMealPlanId;
+    item_count?: number;
+    unchecked_count?: number;
+    created_at: string;
+}
+export type ShoppingListSourceEnum = typeof ShoppingListSourceEnum[keyof typeof ShoppingListSourceEnum];
+export declare const ShoppingListSourceEnum: {
+    readonly manual: "manual";
+    readonly plan: "plan";
+    readonly auto: "auto";
+};
+export type ShoppingListStatusEnum = typeof ShoppingListStatusEnum[keyof typeof ShoppingListStatusEnum];
+export declare const ShoppingListStatusEnum: {
+    readonly active: "active";
+    readonly archived: "archived";
+};
+export type ShoppingListUpdateName = string | null;
+export type ShoppingListUpdateStatus = ShoppingListStatusEnum | null;
+export interface ShoppingListUpdate {
+    name?: ShoppingListUpdateName;
+    status?: ShoppingListUpdateStatus;
+}
+export type SocialTargetEnum = typeof SocialTargetEnum[keyof typeof SocialTargetEnum];
+export declare const SocialTargetEnum: {
+    readonly recipe: "recipe";
+    readonly meal_plan: "meal_plan";
+};
+export type StorageLocationCreateIcon = string | null;
+export type StorageLocationCreateSortOrder = number | null;
+export interface StorageLocationCreate {
+    /**
+     * @minLength 1
+     * @maxLength 100
+     */
+    name: string;
+    icon?: StorageLocationCreateIcon;
+    sort_order?: StorageLocationCreateSortOrder;
+    is_default?: boolean;
+}
+export type StorageLocationResponseIcon = string | null;
+export interface StorageLocationResponse {
+    id: number;
+    household_id: number;
+    name: string;
+    icon?: StorageLocationResponseIcon;
+    sort_order: number;
+    is_default: boolean;
+    is_seed: boolean;
+}
+export type StorageLocationUpdateName = string | null;
+export type StorageLocationUpdateIcon = string | null;
+export type StorageLocationUpdateSortOrder = number | null;
+export type StorageLocationUpdateIsDefault = boolean | null;
+export interface StorageLocationUpdate {
+    name?: StorageLocationUpdateName;
+    icon?: StorageLocationUpdateIcon;
+    sort_order?: StorageLocationUpdateSortOrder;
+    is_default?: StorageLocationUpdateIsDefault;
+}
+export interface SuggestRecipesMetadata {
+    provider: string;
+    model: string;
+    prompt_version: string;
+    candidates_considered: number;
+}
+export type SuggestRecipesRequestCuisine = string | null;
+export type SuggestRecipesRequestServings = number | null;
+export interface SuggestRecipesRequest {
+    /** @maxLength 500 */
+    preferences?: string;
+    cuisine?: SuggestRecipesRequestCuisine;
+    servings?: SuggestRecipesRequestServings;
+    /**
+     * @minimum 1
+     * @maximum 30
+     */
+    expiry_days_threshold?: number;
+    /**
+     * @minimum 1
+     * @maximum 10
+     */
+    max_results?: number;
+}
+export interface SuggestRecipesResponse {
+    suggestions: GroundedSuggestion[];
+    metadata: SuggestRecipesMetadata;
+}
+export type SuggestionIngredientIngredientId = number | null;
+export interface SuggestionIngredient {
+    name: string;
+    ingredient_id?: SuggestionIngredientIngredientId;
+}
+export type TagKindEnum = typeof TagKindEnum[keyof typeof TagKindEnum];
+export declare const TagKindEnum: {
+    readonly cuisine: "cuisine";
+    readonly diet: "diet";
+    readonly course: "course";
+    readonly meal_type: "meal_type";
+};
+export interface Token {
+    access_token: string;
+    token_type: string;
+    email_verified: boolean;
+}
+export interface UserCreate {
+    /**
+     * @minLength 3
+     * @maxLength 150
+     * @pattern ^[a-zA-Z0-9_-]+$
+     */
+    username: string;
+    email: string;
+    /**
+     * @minLength 1
+     * @maxLength 100
+     */
+    first_name: string;
+    /**
+     * @minLength 1
+     * @maxLength 100
+     */
+    last_name: string;
+    /**
+     * @minLength 8
+     * @maxLength 128
+     */
+    password: string;
+}
+export interface UserLogin {
+    email: string;
+    password: string;
+}
+export interface UserResponse {
+    id: number;
+    username: string;
+    email: string;
     first_name: string;
     last_name: string;
     is_active: boolean;
+    email_verified: boolean;
 }
 export type UserUpdateFirstName = string | null;
 export type UserUpdateLastName = string | null;
@@ -228,6 +1422,24 @@ export interface ValidationError {
     input?: unknown;
     ctx?: ValidationErrorCtx;
 }
+export interface VerifyEmailRequest {
+    /** @minLength 1 */
+    token: string;
+}
+export type VisibilityEnum = typeof VisibilityEnum[keyof typeof VisibilityEnum];
+export declare const VisibilityEnum: {
+    readonly private: "private";
+    readonly public: "public";
+};
+export interface VisibilityUpdate {
+    visibility: VisibilityEnum;
+}
+export type VerifyEmailAuthVerifyEmailPost200 = {
+    [key: string]: string;
+};
+export type ResendVerificationAuthResendVerificationPost200 = {
+    [key: string]: string;
+};
 export type UpdateProfileAuthMePatch200 = {
     [key: string]: unknown;
 };
@@ -246,12 +1458,72 @@ export type GetPantryItemsPantryItemsGetParams = {
     limit?: number;
     item_type?: ItemTypeEnum | null;
     expired?: boolean | null;
+    expiring_within_days?: number | null;
+    location_id?: number | null;
+    q?: string | null;
     order_by?: OrderByEnum;
     order?: OrderEnum;
 };
+export type GetInventoryEventsPantryItemsEventsGetParams = {
+    /**
+     * @minimum 0
+     */
+    skip?: number;
+    /**
+     * @minimum 1
+     * @maximum 100
+     */
+    limit?: number;
+    kind?: InventoryEventKindEnum | null;
+    pantry_item_id?: number | null;
+    since?: string | null;
+    order?: OrderEnum;
+};
 export type DeletePantryItemPantryItemsItemIdDelete200 = {
     [key: string]: string;
 };
+export type ConsumePantryItemPantryItemsItemIdConsumePostParams = {
+    delete_when_empty?: boolean;
+};
+export type DeleteStorageLocationLocationsLocationIdDeleteParams = {
+    reassign_to?: number | null;
+};
+export type ListPublicRecipesRecipesPublicGetParams = {
+    q?: string | null;
+    cuisine?: CuisineTypeEnum | null;
+    /**
+     * Comma-separated; matches recipes containing any of these ingredient names
+     */
+    tags?: string | null;
+    min_rating?: number | null;
+    sort?: DiscoverySortEnum;
+    /**
+     * @minimum 0
+     */
+    skip?: number;
+    /**
+     * @minimum 1
+     * @maximum 100
+     */
+    limit?: number;
+};
+export type ListPublicPlansPlansPublicGetParams = {
+    q?: string | null;
+    min_rating?: number | null;
+    sort?: DiscoverySortEnum;
+    /**
+     * @minimum 0
+     */
+    skip?: number;
+    /**
+     * @minimum 1
+     * @maximum 100
+     */
+    limit?: number;
+};
+export type ListFavoritesFavoritesGetParams = {
+    target_type?: SocialTargetEnum | null;
+};
 export type SearchPantryItemsRecipesPantrySearchGetParams = {
     /**
      * Search text
@@ -283,9 +1555,114 @@ export type GetRecipesRecipesGetParams = {
     limit?: number;
     cuisine?: CuisineTypeEnum | null;
 };
+export type GetRecipeSuggestionsRecipesSuggestionsGetParams = {
+    max_missing?: number | null;
+    use_expiring?: boolean;
+    /**
+     * @minimum 1
+     * @maximum 30
+     */
+    expiry_days_threshold?: number;
+    cuisine?: string | null;
+    /**
+     * @minimum 1
+     * @maximum 100
+     */
+    limit?: number;
+};
 export type DeleteRecipeRecipesRecipeIdDelete200 = {
     [key: string]: string;
 };
+export type ListIngredientsCatalogIngredientsGetParams = {
+    q?: string | null;
+    category?: ItemTypeEnum | null;
+    /**
+     * @minimum 0
+     */
+    skip?: number;
+    /**
+     * @minimum 1
+     * @maximum 100
+     */
+    limit?: number;
+};
+export type ListTagsCatalogTagsGetParams = {
+    kind?: TagKindEnum | null;
+};
+export type ListCatalogRecipesCatalogRecipesGetParams = {
+    q?: string | null;
+    /**
+     * Comma-separated ingredient ids (match ANY, best first)
+     */
+    ingredient_ids?: string | null;
+    /**
+     * Comma-separated tag names (recipe must have ALL)
+     */
+    tags?: string | null;
+    cuisine?: string | null;
+    cookable_with_pantry?: boolean;
+    /**
+     * @minimum 0
+     */
+    skip?: number;
+    /**
+     * @minimum 1
+     * @maximum 100
+     */
+    limit?: number;
+};
+export type AutocompleteIngredientsIngredientsAutocompleteGetParams = {
+    /**
+     * @minLength 1
+     * @maxLength 100
+     */
+    q: string;
+    /**
+     * @minimum 1
+     * @maximum 20
+     */
+    limit?: number;
+};
+export type ListPlansPlansGetParams = {
+    kind?: MealPlanKindEnum | null;
+    status?: MealPlanStatusEnum | null;
+    is_template?: boolean | null;
+    visibility?: VisibilityEnum | null;
+    is_preset?: boolean | null;
+};
+export type AdoptPresetPlansPresetsPresetIdAdoptPostParams = {
+    with_starter_list?: boolean;
+};
+export type DeletePlanPlansPlanIdDelete200 = {
+    [key: string]: string;
+};
+export type ListShoppingListsShoppingListsGetParams = {
+    status?: ShoppingListStatusEnum | null;
+};
+export type DeleteShoppingListShoppingListsListIdDelete200 = {
+    [key: string]: string;
+};
+export type DeleteShoppingListItemShoppingListsListIdItemsItemIdDelete200 = {
+    [key: string]: string;
+};
+export type GenerateRecipeAiGenerateRecipePost200 = {
+    [key: string]: unknown;
+};
+export type GenerateMealPlanAiMealPlanPost200 = {
+    [key: string]: unknown;
+};
+export type SemanticSearchAiSearchPost200 = {
+    [key: string]: unknown;
+};
+export type RecognizeItemsAiRecognizeItemsPost200 = {
+    [key: string]: unknown;
+};
+export type RecognizeReceiptAiRecognizeReceiptPost200 = {
+    [key: string]: unknown;
+};
+export type LookupBarcodeAiLookupBarcodePost200 = {
+    [key: string]: unknown;
+};
 export type ReadRootGet200 = {
     [key: string]: string;
 };
@@ -349,6 +1726,87 @@ export declare const useLoginAuthLoginPost: <TError = AxiosError<HTTPValidationE
 }) => UseMutationResult<Awaited<ReturnType<typeof loginAuthLoginPost>>, TError, {
     data: UserLogin;
 }, TContext>;
+/**
+ * Sign in with a Google ID token (find-or-create + link).
+ * @summary Google Login
+ */
+export declare const googleLoginAuthGooglePost: (googleLogin: GoogleLogin, options?: AxiosRequestConfig) => Promise<AxiosResponse<Token>>;
+export declare const getGoogleLoginAuthGooglePostMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof googleLoginAuthGooglePost>>, TError, {
+        data: GoogleLogin;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationOptions<Awaited<ReturnType<typeof googleLoginAuthGooglePost>>, TError, {
+    data: GoogleLogin;
+}, TContext>;
+export type GoogleLoginAuthGooglePostMutationResult = NonNullable<Awaited<ReturnType<typeof googleLoginAuthGooglePost>>>;
+export type GoogleLoginAuthGooglePostMutationBody = GoogleLogin;
+export type GoogleLoginAuthGooglePostMutationError = AxiosError<HTTPValidationError>;
+/**
+* @summary Google Login
+*/
+export declare const useGoogleLoginAuthGooglePost: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof googleLoginAuthGooglePost>>, TError, {
+        data: GoogleLogin;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationResult<Awaited<ReturnType<typeof googleLoginAuthGooglePost>>, TError, {
+    data: GoogleLogin;
+}, TContext>;
+/**
+ * Mark an email verified from a verification token (idempotent).
+ * @summary Verify Email
+ */
+export declare const verifyEmailAuthVerifyEmailPost: (verifyEmailRequest: VerifyEmailRequest, options?: AxiosRequestConfig) => Promise<AxiosResponse<VerifyEmailAuthVerifyEmailPost200>>;
+export declare const getVerifyEmailAuthVerifyEmailPostMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof verifyEmailAuthVerifyEmailPost>>, TError, {
+        data: VerifyEmailRequest;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationOptions<Awaited<ReturnType<typeof verifyEmailAuthVerifyEmailPost>>, TError, {
+    data: VerifyEmailRequest;
+}, TContext>;
+export type VerifyEmailAuthVerifyEmailPostMutationResult = NonNullable<Awaited<ReturnType<typeof verifyEmailAuthVerifyEmailPost>>>;
+export type VerifyEmailAuthVerifyEmailPostMutationBody = VerifyEmailRequest;
+export type VerifyEmailAuthVerifyEmailPostMutationError = AxiosError<HTTPValidationError>;
+/**
+* @summary Verify Email
+*/
+export declare const useVerifyEmailAuthVerifyEmailPost: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof verifyEmailAuthVerifyEmailPost>>, TError, {
+        data: VerifyEmailRequest;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationResult<Awaited<ReturnType<typeof verifyEmailAuthVerifyEmailPost>>, TError, {
+    data: VerifyEmailRequest;
+}, TContext>;
+/**
+ * Send a fresh verification link. Always 200 — never reveals whether the account exists.
+ * @summary Resend Verification
+ */
+export declare const resendVerificationAuthResendVerificationPost: (resendVerificationRequest: ResendVerificationRequest, options?: AxiosRequestConfig) => Promise<AxiosResponse<ResendVerificationAuthResendVerificationPost200>>;
+export declare const getResendVerificationAuthResendVerificationPostMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof resendVerificationAuthResendVerificationPost>>, TError, {
+        data: ResendVerificationRequest;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationOptions<Awaited<ReturnType<typeof resendVerificationAuthResendVerificationPost>>, TError, {
+    data: ResendVerificationRequest;
+}, TContext>;
+export type ResendVerificationAuthResendVerificationPostMutationResult = NonNullable<Awaited<ReturnType<typeof resendVerificationAuthResendVerificationPost>>>;
+export type ResendVerificationAuthResendVerificationPostMutationBody = ResendVerificationRequest;
+export type ResendVerificationAuthResendVerificationPostMutationError = AxiosError<HTTPValidationError>;
+/**
+* @summary Resend Verification
+*/
+export declare const useResendVerificationAuthResendVerificationPost: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof resendVerificationAuthResendVerificationPost>>, TError, {
+        data: ResendVerificationRequest;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationResult<Awaited<ReturnType<typeof resendVerificationAuthResendVerificationPost>>, TError, {
+    data: ResendVerificationRequest;
+}, TContext>;
 /**
  * @summary Get Current User Info
  */
@@ -494,23 +1952,123 @@ export declare function useGetPantryItemsPantryItemsGet<TData = Awaited<ReturnTy
     queryKey: QueryKey;
 };
 /**
- * @summary Get Pantry Item
+ * @summary Bulk Create Pantry Items
  */
-export declare const getPantryItemPantryItemsItemIdGet: (itemId: number, options?: AxiosRequestConfig) => Promise<AxiosResponse<PantryItemResponse>>;
-export declare const getGetPantryItemPantryItemsItemIdGetQueryKey: (itemId?: number) => readonly ["/pantry-items/undefined" | `/pantry-items/${number}`];
-export declare const getGetPantryItemPantryItemsItemIdGetQueryOptions: <TData = Awaited<ReturnType<typeof getPantryItemPantryItemsItemIdGet>>, TError = AxiosError<HTTPValidationError>>(itemId: number, options?: {
-    query?: UseQueryOptions<Awaited<ReturnType<typeof getPantryItemPantryItemsItemIdGet>>, TError, TData>;
+export declare const bulkCreatePantryItemsPantryItemsBulkPost: (pantryItemBulkCreateRequest: PantryItemBulkCreateRequest, options?: AxiosRequestConfig) => Promise<AxiosResponse<BulkResponse>>;
+export declare const getBulkCreatePantryItemsPantryItemsBulkPostMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof bulkCreatePantryItemsPantryItemsBulkPost>>, TError, {
+        data: PantryItemBulkCreateRequest;
+    }, TContext>;
     axios?: AxiosRequestConfig;
-}) => UseQueryOptions<Awaited<ReturnType<typeof getPantryItemPantryItemsItemIdGet>>, TError, TData> & {
-    queryKey: QueryKey;
-};
-export type GetPantryItemPantryItemsItemIdGetQueryResult = NonNullable<Awaited<ReturnType<typeof getPantryItemPantryItemsItemIdGet>>>;
-export type GetPantryItemPantryItemsItemIdGetQueryError = AxiosError<HTTPValidationError>;
+}) => UseMutationOptions<Awaited<ReturnType<typeof bulkCreatePantryItemsPantryItemsBulkPost>>, TError, {
+    data: PantryItemBulkCreateRequest;
+}, TContext>;
+export type BulkCreatePantryItemsPantryItemsBulkPostMutationResult = NonNullable<Awaited<ReturnType<typeof bulkCreatePantryItemsPantryItemsBulkPost>>>;
+export type BulkCreatePantryItemsPantryItemsBulkPostMutationBody = PantryItemBulkCreateRequest;
+export type BulkCreatePantryItemsPantryItemsBulkPostMutationError = AxiosError<HTTPValidationError>;
 /**
- * @summary Get Pantry Item
- */
-export declare function useGetPantryItemPantryItemsItemIdGet<TData = Awaited<ReturnType<typeof getPantryItemPantryItemsItemIdGet>>, TError = AxiosError<HTTPValidationError>>(itemId: number, options?: {
-    query?: UseQueryOptions<Awaited<ReturnType<typeof getPantryItemPantryItemsItemIdGet>>, TError, TData>;
+* @summary Bulk Create Pantry Items
+*/
+export declare const useBulkCreatePantryItemsPantryItemsBulkPost: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof bulkCreatePantryItemsPantryItemsBulkPost>>, TError, {
+        data: PantryItemBulkCreateRequest;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationResult<Awaited<ReturnType<typeof bulkCreatePantryItemsPantryItemsBulkPost>>, TError, {
+    data: PantryItemBulkCreateRequest;
+}, TContext>;
+/**
+ * @summary Bulk Update Pantry Items
+ */
+export declare const bulkUpdatePantryItemsPantryItemsBulkPatch: (pantryItemBulkUpdateRequest: PantryItemBulkUpdateRequest, options?: AxiosRequestConfig) => Promise<AxiosResponse<BulkResponse>>;
+export declare const getBulkUpdatePantryItemsPantryItemsBulkPatchMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof bulkUpdatePantryItemsPantryItemsBulkPatch>>, TError, {
+        data: PantryItemBulkUpdateRequest;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationOptions<Awaited<ReturnType<typeof bulkUpdatePantryItemsPantryItemsBulkPatch>>, TError, {
+    data: PantryItemBulkUpdateRequest;
+}, TContext>;
+export type BulkUpdatePantryItemsPantryItemsBulkPatchMutationResult = NonNullable<Awaited<ReturnType<typeof bulkUpdatePantryItemsPantryItemsBulkPatch>>>;
+export type BulkUpdatePantryItemsPantryItemsBulkPatchMutationBody = PantryItemBulkUpdateRequest;
+export type BulkUpdatePantryItemsPantryItemsBulkPatchMutationError = AxiosError<HTTPValidationError>;
+/**
+* @summary Bulk Update Pantry Items
+*/
+export declare const useBulkUpdatePantryItemsPantryItemsBulkPatch: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof bulkUpdatePantryItemsPantryItemsBulkPatch>>, TError, {
+        data: PantryItemBulkUpdateRequest;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationResult<Awaited<ReturnType<typeof bulkUpdatePantryItemsPantryItemsBulkPatch>>, TError, {
+    data: PantryItemBulkUpdateRequest;
+}, TContext>;
+/**
+ * @summary Bulk Delete Pantry Items
+ */
+export declare const bulkDeletePantryItemsPantryItemsBulkDeletePost: (pantryItemBulkDeleteRequest: PantryItemBulkDeleteRequest, options?: AxiosRequestConfig) => Promise<AxiosResponse<BulkResponse>>;
+export declare const getBulkDeletePantryItemsPantryItemsBulkDeletePostMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof bulkDeletePantryItemsPantryItemsBulkDeletePost>>, TError, {
+        data: PantryItemBulkDeleteRequest;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationOptions<Awaited<ReturnType<typeof bulkDeletePantryItemsPantryItemsBulkDeletePost>>, TError, {
+    data: PantryItemBulkDeleteRequest;
+}, TContext>;
+export type BulkDeletePantryItemsPantryItemsBulkDeletePostMutationResult = NonNullable<Awaited<ReturnType<typeof bulkDeletePantryItemsPantryItemsBulkDeletePost>>>;
+export type BulkDeletePantryItemsPantryItemsBulkDeletePostMutationBody = PantryItemBulkDeleteRequest;
+export type BulkDeletePantryItemsPantryItemsBulkDeletePostMutationError = AxiosError<HTTPValidationError>;
+/**
+* @summary Bulk Delete Pantry Items
+*/
+export declare const useBulkDeletePantryItemsPantryItemsBulkDeletePost: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof bulkDeletePantryItemsPantryItemsBulkDeletePost>>, TError, {
+        data: PantryItemBulkDeleteRequest;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationResult<Awaited<ReturnType<typeof bulkDeletePantryItemsPantryItemsBulkDeletePost>>, TError, {
+    data: PantryItemBulkDeleteRequest;
+}, TContext>;
+/**
+ * @summary Get Inventory Events
+ */
+export declare const getInventoryEventsPantryItemsEventsGet: (params?: GetInventoryEventsPantryItemsEventsGetParams, options?: AxiosRequestConfig) => Promise<AxiosResponse<InventoryEventResponse[]>>;
+export declare const getGetInventoryEventsPantryItemsEventsGetQueryKey: (params?: GetInventoryEventsPantryItemsEventsGetParams) => readonly ["/pantry-items/events", ...GetInventoryEventsPantryItemsEventsGetParams[]];
+export declare const getGetInventoryEventsPantryItemsEventsGetQueryOptions: <TData = Awaited<ReturnType<typeof getInventoryEventsPantryItemsEventsGet>>, TError = AxiosError<HTTPValidationError>>(params?: GetInventoryEventsPantryItemsEventsGetParams, options?: {
+    query?: UseQueryOptions<Awaited<ReturnType<typeof getInventoryEventsPantryItemsEventsGet>>, TError, TData>;
+    axios?: AxiosRequestConfig;
+}) => UseQueryOptions<Awaited<ReturnType<typeof getInventoryEventsPantryItemsEventsGet>>, TError, TData> & {
+    queryKey: QueryKey;
+};
+export type GetInventoryEventsPantryItemsEventsGetQueryResult = NonNullable<Awaited<ReturnType<typeof getInventoryEventsPantryItemsEventsGet>>>;
+export type GetInventoryEventsPantryItemsEventsGetQueryError = AxiosError<HTTPValidationError>;
+/**
+ * @summary Get Inventory Events
+ */
+export declare function useGetInventoryEventsPantryItemsEventsGet<TData = Awaited<ReturnType<typeof getInventoryEventsPantryItemsEventsGet>>, TError = AxiosError<HTTPValidationError>>(params?: GetInventoryEventsPantryItemsEventsGetParams, options?: {
+    query?: UseQueryOptions<Awaited<ReturnType<typeof getInventoryEventsPantryItemsEventsGet>>, TError, TData>;
+    axios?: AxiosRequestConfig;
+}): UseQueryResult<TData, TError> & {
+    queryKey: QueryKey;
+};
+/**
+ * @summary Get Pantry Item
+ */
+export declare const getPantryItemPantryItemsItemIdGet: (itemId: number, options?: AxiosRequestConfig) => Promise<AxiosResponse<PantryItemResponse>>;
+export declare const getGetPantryItemPantryItemsItemIdGetQueryKey: (itemId?: number) => readonly ["/pantry-items/undefined" | `/pantry-items/${number}`];
+export declare const getGetPantryItemPantryItemsItemIdGetQueryOptions: <TData = Awaited<ReturnType<typeof getPantryItemPantryItemsItemIdGet>>, TError = AxiosError<HTTPValidationError>>(itemId: number, options?: {
+    query?: UseQueryOptions<Awaited<ReturnType<typeof getPantryItemPantryItemsItemIdGet>>, TError, TData>;
+    axios?: AxiosRequestConfig;
+}) => UseQueryOptions<Awaited<ReturnType<typeof getPantryItemPantryItemsItemIdGet>>, TError, TData> & {
+    queryKey: QueryKey;
+};
+export type GetPantryItemPantryItemsItemIdGetQueryResult = NonNullable<Awaited<ReturnType<typeof getPantryItemPantryItemsItemIdGet>>>;
+export type GetPantryItemPantryItemsItemIdGetQueryError = AxiosError<HTTPValidationError>;
+/**
+ * @summary Get Pantry Item
+ */
+export declare function useGetPantryItemPantryItemsItemIdGet<TData = Awaited<ReturnType<typeof getPantryItemPantryItemsItemIdGet>>, TError = AxiosError<HTTPValidationError>>(itemId: number, options?: {
+    query?: UseQueryOptions<Awaited<ReturnType<typeof getPantryItemPantryItemsItemIdGet>>, TError, TData>;
     axios?: AxiosRequestConfig;
 }): UseQueryResult<TData, TError> & {
     queryKey: QueryKey;
@@ -571,174 +2129,1919 @@ export declare const useDeletePantryItemPantryItemsItemIdDelete: <TError = Axios
     itemId: number;
 }, TContext>;
 /**
- * @summary Get Recipe Image
+ * @summary Consume Pantry Item
  */
-export declare const getRecipeImageRecipesRecipeImageFilenameGet: (filename: string, options?: AxiosRequestConfig) => Promise<AxiosResponse<unknown>>;
-export declare const getGetRecipeImageRecipesRecipeImageFilenameGetQueryKey: (filename?: string) => readonly [`/recipes/recipe-image/${string}`];
-export declare const getGetRecipeImageRecipesRecipeImageFilenameGetQueryOptions: <TData = Awaited<ReturnType<typeof getRecipeImageRecipesRecipeImageFilenameGet>>, TError = AxiosError<HTTPValidationError>>(filename: string, options?: {
-    query?: UseQueryOptions<Awaited<ReturnType<typeof getRecipeImageRecipesRecipeImageFilenameGet>>, TError, TData>;
+export declare const consumePantryItemPantryItemsItemIdConsumePost: (itemId: number, consumeRequest: ConsumeRequest, params?: ConsumePantryItemPantryItemsItemIdConsumePostParams, options?: AxiosRequestConfig) => Promise<AxiosResponse<ConsumeResponse>>;
+export declare const getConsumePantryItemPantryItemsItemIdConsumePostMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof consumePantryItemPantryItemsItemIdConsumePost>>, TError, {
+        itemId: number;
+        data: ConsumeRequest;
+        params?: ConsumePantryItemPantryItemsItemIdConsumePostParams;
+    }, TContext>;
     axios?: AxiosRequestConfig;
-}) => UseQueryOptions<Awaited<ReturnType<typeof getRecipeImageRecipesRecipeImageFilenameGet>>, TError, TData> & {
+}) => UseMutationOptions<Awaited<ReturnType<typeof consumePantryItemPantryItemsItemIdConsumePost>>, TError, {
+    itemId: number;
+    data: ConsumeRequest;
+    params?: ConsumePantryItemPantryItemsItemIdConsumePostParams;
+}, TContext>;
+export type ConsumePantryItemPantryItemsItemIdConsumePostMutationResult = NonNullable<Awaited<ReturnType<typeof consumePantryItemPantryItemsItemIdConsumePost>>>;
+export type ConsumePantryItemPantryItemsItemIdConsumePostMutationBody = ConsumeRequest;
+export type ConsumePantryItemPantryItemsItemIdConsumePostMutationError = AxiosError<HTTPValidationError>;
+/**
+* @summary Consume Pantry Item
+*/
+export declare const useConsumePantryItemPantryItemsItemIdConsumePost: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof consumePantryItemPantryItemsItemIdConsumePost>>, TError, {
+        itemId: number;
+        data: ConsumeRequest;
+        params?: ConsumePantryItemPantryItemsItemIdConsumePostParams;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationResult<Awaited<ReturnType<typeof consumePantryItemPantryItemsItemIdConsumePost>>, TError, {
+    itemId: number;
+    data: ConsumeRequest;
+    params?: ConsumePantryItemPantryItemsItemIdConsumePostParams;
+}, TContext>;
+/**
+ * @summary List Storage Locations
+ */
+export declare const listStorageLocationsLocationsGet: (options?: AxiosRequestConfig) => Promise<AxiosResponse<StorageLocationResponse[]>>;
+export declare const getListStorageLocationsLocationsGetQueryKey: () => readonly ["/locations/"];
+export declare const getListStorageLocationsLocationsGetQueryOptions: <TData = Awaited<ReturnType<typeof listStorageLocationsLocationsGet>>, TError = AxiosError<unknown>>(options?: {
+    query?: UseQueryOptions<Awaited<ReturnType<typeof listStorageLocationsLocationsGet>>, TError, TData>;
+    axios?: AxiosRequestConfig;
+}) => UseQueryOptions<Awaited<ReturnType<typeof listStorageLocationsLocationsGet>>, TError, TData> & {
     queryKey: QueryKey;
 };
-export type GetRecipeImageRecipesRecipeImageFilenameGetQueryResult = NonNullable<Awaited<ReturnType<typeof getRecipeImageRecipesRecipeImageFilenameGet>>>;
-export type GetRecipeImageRecipesRecipeImageFilenameGetQueryError = AxiosError<HTTPValidationError>;
+export type ListStorageLocationsLocationsGetQueryResult = NonNullable<Awaited<ReturnType<typeof listStorageLocationsLocationsGet>>>;
+export type ListStorageLocationsLocationsGetQueryError = AxiosError<unknown>;
 /**
- * @summary Get Recipe Image
+ * @summary List Storage Locations
  */
-export declare function useGetRecipeImageRecipesRecipeImageFilenameGet<TData = Awaited<ReturnType<typeof getRecipeImageRecipesRecipeImageFilenameGet>>, TError = AxiosError<HTTPValidationError>>(filename: string, options?: {
-    query?: UseQueryOptions<Awaited<ReturnType<typeof getRecipeImageRecipesRecipeImageFilenameGet>>, TError, TData>;
+export declare function useListStorageLocationsLocationsGet<TData = Awaited<ReturnType<typeof listStorageLocationsLocationsGet>>, TError = AxiosError<unknown>>(options?: {
+    query?: UseQueryOptions<Awaited<ReturnType<typeof listStorageLocationsLocationsGet>>, TError, TData>;
     axios?: AxiosRequestConfig;
 }): UseQueryResult<TData, TError> & {
     queryKey: QueryKey;
 };
 /**
- * @summary Search Pantry Items
+ * @summary Create Storage Location
  */
-export declare const searchPantryItemsRecipesPantrySearchGet: (params: SearchPantryItemsRecipesPantrySearchGetParams, options?: AxiosRequestConfig) => Promise<AxiosResponse<SearchPantryItemsRecipesPantrySearchGet200>>;
-export declare const getSearchPantryItemsRecipesPantrySearchGetQueryKey: (params?: SearchPantryItemsRecipesPantrySearchGetParams) => readonly ["/recipes/pantry/search", ...SearchPantryItemsRecipesPantrySearchGetParams[]];
-export declare const getSearchPantryItemsRecipesPantrySearchGetQueryOptions: <TData = Awaited<ReturnType<typeof searchPantryItemsRecipesPantrySearchGet>>, TError = AxiosError<HTTPValidationError>>(params: SearchPantryItemsRecipesPantrySearchGetParams, options?: {
-    query?: UseQueryOptions<Awaited<ReturnType<typeof searchPantryItemsRecipesPantrySearchGet>>, TError, TData>;
+export declare const createStorageLocationLocationsPost: (storageLocationCreate: StorageLocationCreate, options?: AxiosRequestConfig) => Promise<AxiosResponse<StorageLocationResponse>>;
+export declare const getCreateStorageLocationLocationsPostMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof createStorageLocationLocationsPost>>, TError, {
+        data: StorageLocationCreate;
+    }, TContext>;
     axios?: AxiosRequestConfig;
-}) => UseQueryOptions<Awaited<ReturnType<typeof searchPantryItemsRecipesPantrySearchGet>>, TError, TData> & {
+}) => UseMutationOptions<Awaited<ReturnType<typeof createStorageLocationLocationsPost>>, TError, {
+    data: StorageLocationCreate;
+}, TContext>;
+export type CreateStorageLocationLocationsPostMutationResult = NonNullable<Awaited<ReturnType<typeof createStorageLocationLocationsPost>>>;
+export type CreateStorageLocationLocationsPostMutationBody = StorageLocationCreate;
+export type CreateStorageLocationLocationsPostMutationError = AxiosError<HTTPValidationError>;
+/**
+* @summary Create Storage Location
+*/
+export declare const useCreateStorageLocationLocationsPost: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof createStorageLocationLocationsPost>>, TError, {
+        data: StorageLocationCreate;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationResult<Awaited<ReturnType<typeof createStorageLocationLocationsPost>>, TError, {
+    data: StorageLocationCreate;
+}, TContext>;
+/**
+ * @summary Update Storage Location
+ */
+export declare const updateStorageLocationLocationsLocationIdPut: (locationId: number, storageLocationUpdate: StorageLocationUpdate, options?: AxiosRequestConfig) => Promise<AxiosResponse<StorageLocationResponse>>;
+export declare const getUpdateStorageLocationLocationsLocationIdPutMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof updateStorageLocationLocationsLocationIdPut>>, TError, {
+        locationId: number;
+        data: StorageLocationUpdate;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationOptions<Awaited<ReturnType<typeof updateStorageLocationLocationsLocationIdPut>>, TError, {
+    locationId: number;
+    data: StorageLocationUpdate;
+}, TContext>;
+export type UpdateStorageLocationLocationsLocationIdPutMutationResult = NonNullable<Awaited<ReturnType<typeof updateStorageLocationLocationsLocationIdPut>>>;
+export type UpdateStorageLocationLocationsLocationIdPutMutationBody = StorageLocationUpdate;
+export type UpdateStorageLocationLocationsLocationIdPutMutationError = AxiosError<HTTPValidationError>;
+/**
+* @summary Update Storage Location
+*/
+export declare const useUpdateStorageLocationLocationsLocationIdPut: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof updateStorageLocationLocationsLocationIdPut>>, TError, {
+        locationId: number;
+        data: StorageLocationUpdate;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationResult<Awaited<ReturnType<typeof updateStorageLocationLocationsLocationIdPut>>, TError, {
+    locationId: number;
+    data: StorageLocationUpdate;
+}, TContext>;
+/**
+ * @summary Delete Storage Location
+ */
+export declare const deleteStorageLocationLocationsLocationIdDelete: (locationId: number, params?: DeleteStorageLocationLocationsLocationIdDeleteParams, options?: AxiosRequestConfig) => Promise<AxiosResponse<MessageResponse>>;
+export declare const getDeleteStorageLocationLocationsLocationIdDeleteMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof deleteStorageLocationLocationsLocationIdDelete>>, TError, {
+        locationId: number;
+        params?: DeleteStorageLocationLocationsLocationIdDeleteParams;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationOptions<Awaited<ReturnType<typeof deleteStorageLocationLocationsLocationIdDelete>>, TError, {
+    locationId: number;
+    params?: DeleteStorageLocationLocationsLocationIdDeleteParams;
+}, TContext>;
+export type DeleteStorageLocationLocationsLocationIdDeleteMutationResult = NonNullable<Awaited<ReturnType<typeof deleteStorageLocationLocationsLocationIdDelete>>>;
+export type DeleteStorageLocationLocationsLocationIdDeleteMutationError = AxiosError<HTTPValidationError>;
+/**
+* @summary Delete Storage Location
+*/
+export declare const useDeleteStorageLocationLocationsLocationIdDelete: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof deleteStorageLocationLocationsLocationIdDelete>>, TError, {
+        locationId: number;
+        params?: DeleteStorageLocationLocationsLocationIdDeleteParams;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationResult<Awaited<ReturnType<typeof deleteStorageLocationLocationsLocationIdDelete>>, TError, {
+    locationId: number;
+    params?: DeleteStorageLocationLocationsLocationIdDeleteParams;
+}, TContext>;
+/**
+ * The caller's household: id, name, settings document, members, created_at.
+ * @summary Get Household
+ */
+export declare const getHouseholdHouseholdGet: (options?: AxiosRequestConfig) => Promise<AxiosResponse<HouseholdResponse>>;
+export declare const getGetHouseholdHouseholdGetQueryKey: () => readonly ["/household/"];
+export declare const getGetHouseholdHouseholdGetQueryOptions: <TData = Awaited<ReturnType<typeof getHouseholdHouseholdGet>>, TError = AxiosError<unknown>>(options?: {
+    query?: UseQueryOptions<Awaited<ReturnType<typeof getHouseholdHouseholdGet>>, TError, TData>;
+    axios?: AxiosRequestConfig;
+}) => UseQueryOptions<Awaited<ReturnType<typeof getHouseholdHouseholdGet>>, TError, TData> & {
     queryKey: QueryKey;
 };
-export type SearchPantryItemsRecipesPantrySearchGetQueryResult = NonNullable<Awaited<ReturnType<typeof searchPantryItemsRecipesPantrySearchGet>>>;
-export type SearchPantryItemsRecipesPantrySearchGetQueryError = AxiosError<HTTPValidationError>;
+export type GetHouseholdHouseholdGetQueryResult = NonNullable<Awaited<ReturnType<typeof getHouseholdHouseholdGet>>>;
+export type GetHouseholdHouseholdGetQueryError = AxiosError<unknown>;
 /**
- * @summary Search Pantry Items
+ * @summary Get Household
  */
-export declare function useSearchPantryItemsRecipesPantrySearchGet<TData = Awaited<ReturnType<typeof searchPantryItemsRecipesPantrySearchGet>>, TError = AxiosError<HTTPValidationError>>(params: SearchPantryItemsRecipesPantrySearchGetParams, options?: {
-    query?: UseQueryOptions<Awaited<ReturnType<typeof searchPantryItemsRecipesPantrySearchGet>>, TError, TData>;
+export declare function useGetHouseholdHouseholdGet<TData = Awaited<ReturnType<typeof getHouseholdHouseholdGet>>, TError = AxiosError<unknown>>(options?: {
+    query?: UseQueryOptions<Awaited<ReturnType<typeof getHouseholdHouseholdGet>>, TError, TData>;
     axios?: AxiosRequestConfig;
 }): UseQueryResult<TData, TError> & {
     queryKey: QueryKey;
 };
 /**
- * @summary Create Recipe
+ * Partially update household name and/or settings (settings keys merge).
+ * @summary Update Household
  */
-export declare const createRecipeRecipesPost: (bodyCreateRecipeRecipesPost: BodyCreateRecipeRecipesPost, options?: AxiosRequestConfig) => Promise<AxiosResponse<RecipeResponse>>;
-export declare const getCreateRecipeRecipesPostMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
-    mutation?: UseMutationOptions<Awaited<ReturnType<typeof createRecipeRecipesPost>>, TError, {
-        data: BodyCreateRecipeRecipesPost;
+export declare const updateHouseholdHouseholdPatch: (householdUpdate: HouseholdUpdate, options?: AxiosRequestConfig) => Promise<AxiosResponse<HouseholdResponse>>;
+export declare const getUpdateHouseholdHouseholdPatchMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof updateHouseholdHouseholdPatch>>, TError, {
+        data: HouseholdUpdate;
     }, TContext>;
     axios?: AxiosRequestConfig;
-}) => UseMutationOptions<Awaited<ReturnType<typeof createRecipeRecipesPost>>, TError, {
-    data: BodyCreateRecipeRecipesPost;
+}) => UseMutationOptions<Awaited<ReturnType<typeof updateHouseholdHouseholdPatch>>, TError, {
+    data: HouseholdUpdate;
 }, TContext>;
-export type CreateRecipeRecipesPostMutationResult = NonNullable<Awaited<ReturnType<typeof createRecipeRecipesPost>>>;
-export type CreateRecipeRecipesPostMutationBody = BodyCreateRecipeRecipesPost;
-export type CreateRecipeRecipesPostMutationError = AxiosError<HTTPValidationError>;
+export type UpdateHouseholdHouseholdPatchMutationResult = NonNullable<Awaited<ReturnType<typeof updateHouseholdHouseholdPatch>>>;
+export type UpdateHouseholdHouseholdPatchMutationBody = HouseholdUpdate;
+export type UpdateHouseholdHouseholdPatchMutationError = AxiosError<HTTPValidationError>;
 /**
-* @summary Create Recipe
+* @summary Update Household
 */
-export declare const useCreateRecipeRecipesPost: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
-    mutation?: UseMutationOptions<Awaited<ReturnType<typeof createRecipeRecipesPost>>, TError, {
-        data: BodyCreateRecipeRecipesPost;
+export declare const useUpdateHouseholdHouseholdPatch: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof updateHouseholdHouseholdPatch>>, TError, {
+        data: HouseholdUpdate;
     }, TContext>;
     axios?: AxiosRequestConfig;
-}) => UseMutationResult<Awaited<ReturnType<typeof createRecipeRecipesPost>>, TError, {
-    data: BodyCreateRecipeRecipesPost;
+}) => UseMutationResult<Awaited<ReturnType<typeof updateHouseholdHouseholdPatch>>, TError, {
+    data: HouseholdUpdate;
 }, TContext>;
 /**
- * @summary Get Recipes
+ * List the household's members (MVP personal households: just the caller).
+ * @summary List Household Members
  */
-export declare const getRecipesRecipesGet: (params?: GetRecipesRecipesGetParams, options?: AxiosRequestConfig) => Promise<AxiosResponse<RecipeResponse[]>>;
-export declare const getGetRecipesRecipesGetQueryKey: (params?: GetRecipesRecipesGetParams) => readonly ["/recipes/", ...GetRecipesRecipesGetParams[]];
-export declare const getGetRecipesRecipesGetQueryOptions: <TData = Awaited<ReturnType<typeof getRecipesRecipesGet>>, TError = AxiosError<HTTPValidationError>>(params?: GetRecipesRecipesGetParams, options?: {
-    query?: UseQueryOptions<Awaited<ReturnType<typeof getRecipesRecipesGet>>, TError, TData>;
+export declare const listHouseholdMembersHouseholdMembersGet: (options?: AxiosRequestConfig) => Promise<AxiosResponse<HouseholdMemberOut[]>>;
+export declare const getListHouseholdMembersHouseholdMembersGetQueryKey: () => readonly ["/household/members"];
+export declare const getListHouseholdMembersHouseholdMembersGetQueryOptions: <TData = Awaited<ReturnType<typeof listHouseholdMembersHouseholdMembersGet>>, TError = AxiosError<unknown>>(options?: {
+    query?: UseQueryOptions<Awaited<ReturnType<typeof listHouseholdMembersHouseholdMembersGet>>, TError, TData>;
     axios?: AxiosRequestConfig;
-}) => UseQueryOptions<Awaited<ReturnType<typeof getRecipesRecipesGet>>, TError, TData> & {
+}) => UseQueryOptions<Awaited<ReturnType<typeof listHouseholdMembersHouseholdMembersGet>>, TError, TData> & {
     queryKey: QueryKey;
 };
-export type GetRecipesRecipesGetQueryResult = NonNullable<Awaited<ReturnType<typeof getRecipesRecipesGet>>>;
-export type GetRecipesRecipesGetQueryError = AxiosError<HTTPValidationError>;
+export type ListHouseholdMembersHouseholdMembersGetQueryResult = NonNullable<Awaited<ReturnType<typeof listHouseholdMembersHouseholdMembersGet>>>;
+export type ListHouseholdMembersHouseholdMembersGetQueryError = AxiosError<unknown>;
 /**
- * @summary Get Recipes
+ * @summary List Household Members
  */
-export declare function useGetRecipesRecipesGet<TData = Awaited<ReturnType<typeof getRecipesRecipesGet>>, TError = AxiosError<HTTPValidationError>>(params?: GetRecipesRecipesGetParams, options?: {
-    query?: UseQueryOptions<Awaited<ReturnType<typeof getRecipesRecipesGet>>, TError, TData>;
+export declare function useListHouseholdMembersHouseholdMembersGet<TData = Awaited<ReturnType<typeof listHouseholdMembersHouseholdMembersGet>>, TError = AxiosError<unknown>>(options?: {
+    query?: UseQueryOptions<Awaited<ReturnType<typeof listHouseholdMembersHouseholdMembersGet>>, TError, TData>;
     axios?: AxiosRequestConfig;
 }): UseQueryResult<TData, TError> & {
     queryKey: QueryKey;
 };
 /**
- * @summary Get Recipe
+ * One aggregate call for the app home screen, household-scoped.
+
+``suggested_recipes`` is the top-3 deterministic coverage ranking (P2,
+same service as /recipes/suggestions). ``active_plan`` (P3) is the
+household's active meal plan with today's slots — null when no plan is
+active.
+ * @summary Get Dashboard Summary
  */
-export declare const getRecipeRecipesRecipeIdGet: (recipeId: number, options?: AxiosRequestConfig) => Promise<AxiosResponse<RecipeResponse>>;
-export declare const getGetRecipeRecipesRecipeIdGetQueryKey: (recipeId?: number) => readonly ["/recipes/undefined" | `/recipes/${number}`];
-export declare const getGetRecipeRecipesRecipeIdGetQueryOptions: <TData = Awaited<ReturnType<typeof getRecipeRecipesRecipeIdGet>>, TError = AxiosError<HTTPValidationError>>(recipeId: number, options?: {
-    query?: UseQueryOptions<Awaited<ReturnType<typeof getRecipeRecipesRecipeIdGet>>, TError, TData>;
+export declare const getDashboardSummaryDashboardSummaryGet: (options?: AxiosRequestConfig) => Promise<AxiosResponse<DashboardSummaryResponse>>;
+export declare const getGetDashboardSummaryDashboardSummaryGetQueryKey: () => readonly ["/dashboard/summary"];
+export declare const getGetDashboardSummaryDashboardSummaryGetQueryOptions: <TData = Awaited<ReturnType<typeof getDashboardSummaryDashboardSummaryGet>>, TError = AxiosError<unknown>>(options?: {
+    query?: UseQueryOptions<Awaited<ReturnType<typeof getDashboardSummaryDashboardSummaryGet>>, TError, TData>;
     axios?: AxiosRequestConfig;
-}) => UseQueryOptions<Awaited<ReturnType<typeof getRecipeRecipesRecipeIdGet>>, TError, TData> & {
+}) => UseQueryOptions<Awaited<ReturnType<typeof getDashboardSummaryDashboardSummaryGet>>, TError, TData> & {
     queryKey: QueryKey;
 };
-export type GetRecipeRecipesRecipeIdGetQueryResult = NonNullable<Awaited<ReturnType<typeof getRecipeRecipesRecipeIdGet>>>;
-export type GetRecipeRecipesRecipeIdGetQueryError = AxiosError<HTTPValidationError>;
+export type GetDashboardSummaryDashboardSummaryGetQueryResult = NonNullable<Awaited<ReturnType<typeof getDashboardSummaryDashboardSummaryGet>>>;
+export type GetDashboardSummaryDashboardSummaryGetQueryError = AxiosError<unknown>;
 /**
- * @summary Get Recipe
+ * @summary Get Dashboard Summary
  */
-export declare function useGetRecipeRecipesRecipeIdGet<TData = Awaited<ReturnType<typeof getRecipeRecipesRecipeIdGet>>, TError = AxiosError<HTTPValidationError>>(recipeId: number, options?: {
-    query?: UseQueryOptions<Awaited<ReturnType<typeof getRecipeRecipesRecipeIdGet>>, TError, TData>;
+export declare function useGetDashboardSummaryDashboardSummaryGet<TData = Awaited<ReturnType<typeof getDashboardSummaryDashboardSummaryGet>>, TError = AxiosError<unknown>>(options?: {
+    query?: UseQueryOptions<Awaited<ReturnType<typeof getDashboardSummaryDashboardSummaryGet>>, TError, TData>;
     axios?: AxiosRequestConfig;
 }): UseQueryResult<TData, TError> & {
     queryKey: QueryKey;
 };
 /**
- * @summary Update Recipe
+ * Set visibility (private|public) on my own recipe (§5.7). 404 — not
+403 — for recipes I don't own, per the private-by-default posture (§12).
+ * @summary Set Recipe Visibility
  */
-export declare const updateRecipeRecipesRecipeIdPut: (recipeId: number, bodyUpdateRecipeRecipesRecipeIdPut: BodyUpdateRecipeRecipesRecipeIdPut, options?: AxiosRequestConfig) => Promise<AxiosResponse<RecipeResponse>>;
-export declare const getUpdateRecipeRecipesRecipeIdPutMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
-    mutation?: UseMutationOptions<Awaited<ReturnType<typeof updateRecipeRecipesRecipeIdPut>>, TError, {
+export declare const setRecipeVisibilityRecipesRecipeIdVisibilityPut: (recipeId: number, visibilityUpdate: VisibilityUpdate, options?: AxiosRequestConfig) => Promise<AxiosResponse<RecipeResponse>>;
+export declare const getSetRecipeVisibilityRecipesRecipeIdVisibilityPutMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof setRecipeVisibilityRecipesRecipeIdVisibilityPut>>, TError, {
         recipeId: number;
-        data: BodyUpdateRecipeRecipesRecipeIdPut;
+        data: VisibilityUpdate;
     }, TContext>;
     axios?: AxiosRequestConfig;
-}) => UseMutationOptions<Awaited<ReturnType<typeof updateRecipeRecipesRecipeIdPut>>, TError, {
+}) => UseMutationOptions<Awaited<ReturnType<typeof setRecipeVisibilityRecipesRecipeIdVisibilityPut>>, TError, {
     recipeId: number;
-    data: BodyUpdateRecipeRecipesRecipeIdPut;
+    data: VisibilityUpdate;
 }, TContext>;
-export type UpdateRecipeRecipesRecipeIdPutMutationResult = NonNullable<Awaited<ReturnType<typeof updateRecipeRecipesRecipeIdPut>>>;
-export type UpdateRecipeRecipesRecipeIdPutMutationBody = BodyUpdateRecipeRecipesRecipeIdPut;
-export type UpdateRecipeRecipesRecipeIdPutMutationError = AxiosError<HTTPValidationError>;
+export type SetRecipeVisibilityRecipesRecipeIdVisibilityPutMutationResult = NonNullable<Awaited<ReturnType<typeof setRecipeVisibilityRecipesRecipeIdVisibilityPut>>>;
+export type SetRecipeVisibilityRecipesRecipeIdVisibilityPutMutationBody = VisibilityUpdate;
+export type SetRecipeVisibilityRecipesRecipeIdVisibilityPutMutationError = AxiosError<HTTPValidationError>;
 /**
-* @summary Update Recipe
+* @summary Set Recipe Visibility
 */
-export declare const useUpdateRecipeRecipesRecipeIdPut: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
-    mutation?: UseMutationOptions<Awaited<ReturnType<typeof updateRecipeRecipesRecipeIdPut>>, TError, {
+export declare const useSetRecipeVisibilityRecipesRecipeIdVisibilityPut: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof setRecipeVisibilityRecipesRecipeIdVisibilityPut>>, TError, {
         recipeId: number;
-        data: BodyUpdateRecipeRecipesRecipeIdPut;
+        data: VisibilityUpdate;
     }, TContext>;
     axios?: AxiosRequestConfig;
-}) => UseMutationResult<Awaited<ReturnType<typeof updateRecipeRecipesRecipeIdPut>>, TError, {
+}) => UseMutationResult<Awaited<ReturnType<typeof setRecipeVisibilityRecipesRecipeIdVisibilityPut>>, TError, {
     recipeId: number;
-    data: BodyUpdateRecipeRecipesRecipeIdPut;
+    data: VisibilityUpdate;
 }, TContext>;
 /**
- * @summary Delete Recipe
+ * Set visibility (private|public) on a household-owned plan (§5.7).
+ * @summary Set Plan Visibility
  */
-export declare const deleteRecipeRecipesRecipeIdDelete: (recipeId: number, options?: AxiosRequestConfig) => Promise<AxiosResponse<DeleteRecipeRecipesRecipeIdDelete200>>;
-export declare const getDeleteRecipeRecipesRecipeIdDeleteMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
-    mutation?: UseMutationOptions<Awaited<ReturnType<typeof deleteRecipeRecipesRecipeIdDelete>>, TError, {
+export declare const setPlanVisibilityPlansPlanIdVisibilityPut: (planId: number, visibilityUpdate: VisibilityUpdate, options?: AxiosRequestConfig) => Promise<AxiosResponse<MealPlanDetailResponse>>;
+export declare const getSetPlanVisibilityPlansPlanIdVisibilityPutMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof setPlanVisibilityPlansPlanIdVisibilityPut>>, TError, {
+        planId: number;
+        data: VisibilityUpdate;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationOptions<Awaited<ReturnType<typeof setPlanVisibilityPlansPlanIdVisibilityPut>>, TError, {
+    planId: number;
+    data: VisibilityUpdate;
+}, TContext>;
+export type SetPlanVisibilityPlansPlanIdVisibilityPutMutationResult = NonNullable<Awaited<ReturnType<typeof setPlanVisibilityPlansPlanIdVisibilityPut>>>;
+export type SetPlanVisibilityPlansPlanIdVisibilityPutMutationBody = VisibilityUpdate;
+export type SetPlanVisibilityPlansPlanIdVisibilityPutMutationError = AxiosError<HTTPValidationError>;
+/**
+* @summary Set Plan Visibility
+*/
+export declare const useSetPlanVisibilityPlansPlanIdVisibilityPut: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof setPlanVisibilityPlansPlanIdVisibilityPut>>, TError, {
+        planId: number;
+        data: VisibilityUpdate;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationResult<Awaited<ReturnType<typeof setPlanVisibilityPlansPlanIdVisibilityPut>>, TError, {
+    planId: number;
+    data: VisibilityUpdate;
+}, TContext>;
+/**
+ * Public recipe discovery (D3: Reddit-style). Only visibility='public'
+rows are ever returned; rating/favorite stats are embedded.
+ * @summary List Public Recipes
+ */
+export declare const listPublicRecipesRecipesPublicGet: (params?: ListPublicRecipesRecipesPublicGetParams, options?: AxiosRequestConfig) => Promise<AxiosResponse<PublicRecipeSummary[]>>;
+export declare const getListPublicRecipesRecipesPublicGetQueryKey: (params?: ListPublicRecipesRecipesPublicGetParams) => readonly ["/recipes/public", ...ListPublicRecipesRecipesPublicGetParams[]];
+export declare const getListPublicRecipesRecipesPublicGetQueryOptions: <TData = Awaited<ReturnType<typeof listPublicRecipesRecipesPublicGet>>, TError = AxiosError<HTTPValidationError>>(params?: ListPublicRecipesRecipesPublicGetParams, options?: {
+    query?: UseQueryOptions<Awaited<ReturnType<typeof listPublicRecipesRecipesPublicGet>>, TError, TData>;
+    axios?: AxiosRequestConfig;
+}) => UseQueryOptions<Awaited<ReturnType<typeof listPublicRecipesRecipesPublicGet>>, TError, TData> & {
+    queryKey: QueryKey;
+};
+export type ListPublicRecipesRecipesPublicGetQueryResult = NonNullable<Awaited<ReturnType<typeof listPublicRecipesRecipesPublicGet>>>;
+export type ListPublicRecipesRecipesPublicGetQueryError = AxiosError<HTTPValidationError>;
+/**
+ * @summary List Public Recipes
+ */
+export declare function useListPublicRecipesRecipesPublicGet<TData = Awaited<ReturnType<typeof listPublicRecipesRecipesPublicGet>>, TError = AxiosError<HTTPValidationError>>(params?: ListPublicRecipesRecipesPublicGetParams, options?: {
+    query?: UseQueryOptions<Awaited<ReturnType<typeof listPublicRecipesRecipesPublicGet>>, TError, TData>;
+    axios?: AxiosRequestConfig;
+}): UseQueryResult<TData, TError> & {
+    queryKey: QueryKey;
+};
+/**
+ * Public meal plan discovery. (Plans have no cuisine/tags fields — those
+discovery filters exist on /recipes/public only.)
+ * @summary List Public Plans
+ */
+export declare const listPublicPlansPlansPublicGet: (params?: ListPublicPlansPlansPublicGetParams, options?: AxiosRequestConfig) => Promise<AxiosResponse<PublicPlanSummary[]>>;
+export declare const getListPublicPlansPlansPublicGetQueryKey: (params?: ListPublicPlansPlansPublicGetParams) => readonly ["/plans/public", ...ListPublicPlansPlansPublicGetParams[]];
+export declare const getListPublicPlansPlansPublicGetQueryOptions: <TData = Awaited<ReturnType<typeof listPublicPlansPlansPublicGet>>, TError = AxiosError<HTTPValidationError>>(params?: ListPublicPlansPlansPublicGetParams, options?: {
+    query?: UseQueryOptions<Awaited<ReturnType<typeof listPublicPlansPlansPublicGet>>, TError, TData>;
+    axios?: AxiosRequestConfig;
+}) => UseQueryOptions<Awaited<ReturnType<typeof listPublicPlansPlansPublicGet>>, TError, TData> & {
+    queryKey: QueryKey;
+};
+export type ListPublicPlansPlansPublicGetQueryResult = NonNullable<Awaited<ReturnType<typeof listPublicPlansPlansPublicGet>>>;
+export type ListPublicPlansPlansPublicGetQueryError = AxiosError<HTTPValidationError>;
+/**
+ * @summary List Public Plans
+ */
+export declare function useListPublicPlansPlansPublicGet<TData = Awaited<ReturnType<typeof listPublicPlansPlansPublicGet>>, TError = AxiosError<HTTPValidationError>>(params?: ListPublicPlansPlansPublicGetParams, options?: {
+    query?: UseQueryOptions<Awaited<ReturnType<typeof listPublicPlansPlansPublicGet>>, TError, TData>;
+    axios?: AxiosRequestConfig;
+}): UseQueryResult<TData, TError> & {
+    queryKey: QueryKey;
+};
+/**
+ * Copy a recipe I can see (public, or my own) into my library
+(D3: Spotify-playlist-style). The copy starts private, records
+provenance (source=forked, forked_from_recipe_id), and is fully
+independent of the original.
+ * @summary Fork Recipe
+ */
+export declare const forkRecipeRecipesRecipeIdForkPost: (recipeId: number, options?: AxiosRequestConfig) => Promise<AxiosResponse<RecipeResponse>>;
+export declare const getForkRecipeRecipesRecipeIdForkPostMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof forkRecipeRecipesRecipeIdForkPost>>, TError, {
         recipeId: number;
     }, TContext>;
     axios?: AxiosRequestConfig;
-}) => UseMutationOptions<Awaited<ReturnType<typeof deleteRecipeRecipesRecipeIdDelete>>, TError, {
+}) => UseMutationOptions<Awaited<ReturnType<typeof forkRecipeRecipesRecipeIdForkPost>>, TError, {
     recipeId: number;
 }, TContext>;
-export type DeleteRecipeRecipesRecipeIdDeleteMutationResult = NonNullable<Awaited<ReturnType<typeof deleteRecipeRecipesRecipeIdDelete>>>;
-export type DeleteRecipeRecipesRecipeIdDeleteMutationError = AxiosError<HTTPValidationError>;
+export type ForkRecipeRecipesRecipeIdForkPostMutationResult = NonNullable<Awaited<ReturnType<typeof forkRecipeRecipesRecipeIdForkPost>>>;
+export type ForkRecipeRecipesRecipeIdForkPostMutationError = AxiosError<HTTPValidationError>;
 /**
-* @summary Delete Recipe
+* @summary Fork Recipe
 */
-export declare const useDeleteRecipeRecipesRecipeIdDelete: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
-    mutation?: UseMutationOptions<Awaited<ReturnType<typeof deleteRecipeRecipesRecipeIdDelete>>, TError, {
+export declare const useForkRecipeRecipesRecipeIdForkPost: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof forkRecipeRecipesRecipeIdForkPost>>, TError, {
         recipeId: number;
     }, TContext>;
     axios?: AxiosRequestConfig;
-}) => UseMutationResult<Awaited<ReturnType<typeof deleteRecipeRecipesRecipeIdDelete>>, TError, {
+}) => UseMutationResult<Awaited<ReturnType<typeof forkRecipeRecipesRecipeIdForkPost>>, TError, {
     recipeId: number;
 }, TContext>;
+/**
+ * Copy a plan I can see (public / preset / my own) into my household.
+User-recipe slots are forked along (so the copy stays independent);
+catalog references stay (global); slots pointing at recipes I cannot see
+become explicit skips.
+ * @summary Fork Plan
+ */
+export declare const forkPlanPlansPlanIdForkPost: (planId: number, options?: AxiosRequestConfig) => Promise<AxiosResponse<MealPlanDetailResponse>>;
+export declare const getForkPlanPlansPlanIdForkPostMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof forkPlanPlansPlanIdForkPost>>, TError, {
+        planId: number;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationOptions<Awaited<ReturnType<typeof forkPlanPlansPlanIdForkPost>>, TError, {
+    planId: number;
+}, TContext>;
+export type ForkPlanPlansPlanIdForkPostMutationResult = NonNullable<Awaited<ReturnType<typeof forkPlanPlansPlanIdForkPost>>>;
+export type ForkPlanPlansPlanIdForkPostMutationError = AxiosError<HTTPValidationError>;
+/**
+* @summary Fork Plan
+*/
+export declare const useForkPlanPlansPlanIdForkPost: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof forkPlanPlansPlanIdForkPost>>, TError, {
+        planId: number;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationResult<Awaited<ReturnType<typeof forkPlanPlansPlanIdForkPost>>, TError, {
+    planId: number;
+}, TContext>;
+/**
+ * Favorite a recipe or plan I can see (own private + public — §5.7).
+Idempotent: re-adding returns the existing favorite.
+ * @summary Add Favorite
+ */
+export declare const addFavoriteFavoritesTargetTypeTargetIdPost: (targetType: SocialTargetEnum, targetId: number, options?: AxiosRequestConfig) => Promise<AxiosResponse<FavoriteResponse>>;
+export declare const getAddFavoriteFavoritesTargetTypeTargetIdPostMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof addFavoriteFavoritesTargetTypeTargetIdPost>>, TError, {
+        targetType: SocialTargetEnum;
+        targetId: number;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationOptions<Awaited<ReturnType<typeof addFavoriteFavoritesTargetTypeTargetIdPost>>, TError, {
+    targetType: SocialTargetEnum;
+    targetId: number;
+}, TContext>;
+export type AddFavoriteFavoritesTargetTypeTargetIdPostMutationResult = NonNullable<Awaited<ReturnType<typeof addFavoriteFavoritesTargetTypeTargetIdPost>>>;
+export type AddFavoriteFavoritesTargetTypeTargetIdPostMutationError = AxiosError<HTTPValidationError>;
+/**
+* @summary Add Favorite
+*/
+export declare const useAddFavoriteFavoritesTargetTypeTargetIdPost: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof addFavoriteFavoritesTargetTypeTargetIdPost>>, TError, {
+        targetType: SocialTargetEnum;
+        targetId: number;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationResult<Awaited<ReturnType<typeof addFavoriteFavoritesTargetTypeTargetIdPost>>, TError, {
+    targetType: SocialTargetEnum;
+    targetId: number;
+}, TContext>;
+/**
+ * @summary Remove Favorite
+ */
+export declare const removeFavoriteFavoritesTargetTypeTargetIdDelete: (targetType: SocialTargetEnum, targetId: number, options?: AxiosRequestConfig) => Promise<AxiosResponse<MessageResponse>>;
+export declare const getRemoveFavoriteFavoritesTargetTypeTargetIdDeleteMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof removeFavoriteFavoritesTargetTypeTargetIdDelete>>, TError, {
+        targetType: SocialTargetEnum;
+        targetId: number;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationOptions<Awaited<ReturnType<typeof removeFavoriteFavoritesTargetTypeTargetIdDelete>>, TError, {
+    targetType: SocialTargetEnum;
+    targetId: number;
+}, TContext>;
+export type RemoveFavoriteFavoritesTargetTypeTargetIdDeleteMutationResult = NonNullable<Awaited<ReturnType<typeof removeFavoriteFavoritesTargetTypeTargetIdDelete>>>;
+export type RemoveFavoriteFavoritesTargetTypeTargetIdDeleteMutationError = AxiosError<HTTPValidationError>;
+/**
+* @summary Remove Favorite
+*/
+export declare const useRemoveFavoriteFavoritesTargetTypeTargetIdDelete: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof removeFavoriteFavoritesTargetTypeTargetIdDelete>>, TError, {
+        targetType: SocialTargetEnum;
+        targetId: number;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationResult<Awaited<ReturnType<typeof removeFavoriteFavoritesTargetTypeTargetIdDelete>>, TError, {
+    targetType: SocialTargetEnum;
+    targetId: number;
+}, TContext>;
+/**
+ * My favorites. Targets that went private since I favorited them are
+hidden (they stay valid for users who can still see them — §12).
+ * @summary List Favorites
+ */
+export declare const listFavoritesFavoritesGet: (params?: ListFavoritesFavoritesGetParams, options?: AxiosRequestConfig) => Promise<AxiosResponse<FavoriteResponse[]>>;
+export declare const getListFavoritesFavoritesGetQueryKey: (params?: ListFavoritesFavoritesGetParams) => readonly ["/favorites/", ...ListFavoritesFavoritesGetParams[]];
+export declare const getListFavoritesFavoritesGetQueryOptions: <TData = Awaited<ReturnType<typeof listFavoritesFavoritesGet>>, TError = AxiosError<HTTPValidationError>>(params?: ListFavoritesFavoritesGetParams, options?: {
+    query?: UseQueryOptions<Awaited<ReturnType<typeof listFavoritesFavoritesGet>>, TError, TData>;
+    axios?: AxiosRequestConfig;
+}) => UseQueryOptions<Awaited<ReturnType<typeof listFavoritesFavoritesGet>>, TError, TData> & {
+    queryKey: QueryKey;
+};
+export type ListFavoritesFavoritesGetQueryResult = NonNullable<Awaited<ReturnType<typeof listFavoritesFavoritesGet>>>;
+export type ListFavoritesFavoritesGetQueryError = AxiosError<HTTPValidationError>;
+/**
+ * @summary List Favorites
+ */
+export declare function useListFavoritesFavoritesGet<TData = Awaited<ReturnType<typeof listFavoritesFavoritesGet>>, TError = AxiosError<HTTPValidationError>>(params?: ListFavoritesFavoritesGetParams, options?: {
+    query?: UseQueryOptions<Awaited<ReturnType<typeof listFavoritesFavoritesGet>>, TError, TData>;
+    axios?: AxiosRequestConfig;
+}): UseQueryResult<TData, TError> & {
+    queryKey: QueryKey;
+};
+/**
+ * Upsert my rating (stars 1..5 + optional detailed review — D3) on
+anything I can see (own private + public).
+ * @summary Upsert Rating
+ */
+export declare const upsertRatingRatingsTargetTypeTargetIdPut: (targetType: SocialTargetEnum, targetId: number, ratingUpsert: RatingUpsert, options?: AxiosRequestConfig) => Promise<AxiosResponse<ReviewOut>>;
+export declare const getUpsertRatingRatingsTargetTypeTargetIdPutMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof upsertRatingRatingsTargetTypeTargetIdPut>>, TError, {
+        targetType: SocialTargetEnum;
+        targetId: number;
+        data: RatingUpsert;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationOptions<Awaited<ReturnType<typeof upsertRatingRatingsTargetTypeTargetIdPut>>, TError, {
+    targetType: SocialTargetEnum;
+    targetId: number;
+    data: RatingUpsert;
+}, TContext>;
+export type UpsertRatingRatingsTargetTypeTargetIdPutMutationResult = NonNullable<Awaited<ReturnType<typeof upsertRatingRatingsTargetTypeTargetIdPut>>>;
+export type UpsertRatingRatingsTargetTypeTargetIdPutMutationBody = RatingUpsert;
+export type UpsertRatingRatingsTargetTypeTargetIdPutMutationError = AxiosError<HTTPValidationError>;
+/**
+* @summary Upsert Rating
+*/
+export declare const useUpsertRatingRatingsTargetTypeTargetIdPut: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof upsertRatingRatingsTargetTypeTargetIdPut>>, TError, {
+        targetType: SocialTargetEnum;
+        targetId: number;
+        data: RatingUpsert;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationResult<Awaited<ReturnType<typeof upsertRatingRatingsTargetTypeTargetIdPut>>, TError, {
+    targetType: SocialTargetEnum;
+    targetId: number;
+    data: RatingUpsert;
+}, TContext>;
+/**
+ * Delete my rating (review photos and their files go with it).
+ * @summary Delete Rating
+ */
+export declare const deleteRatingRatingsTargetTypeTargetIdDelete: (targetType: SocialTargetEnum, targetId: number, options?: AxiosRequestConfig) => Promise<AxiosResponse<MessageResponse>>;
+export declare const getDeleteRatingRatingsTargetTypeTargetIdDeleteMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof deleteRatingRatingsTargetTypeTargetIdDelete>>, TError, {
+        targetType: SocialTargetEnum;
+        targetId: number;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationOptions<Awaited<ReturnType<typeof deleteRatingRatingsTargetTypeTargetIdDelete>>, TError, {
+    targetType: SocialTargetEnum;
+    targetId: number;
+}, TContext>;
+export type DeleteRatingRatingsTargetTypeTargetIdDeleteMutationResult = NonNullable<Awaited<ReturnType<typeof deleteRatingRatingsTargetTypeTargetIdDelete>>>;
+export type DeleteRatingRatingsTargetTypeTargetIdDeleteMutationError = AxiosError<HTTPValidationError>;
+/**
+* @summary Delete Rating
+*/
+export declare const useDeleteRatingRatingsTargetTypeTargetIdDelete: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof deleteRatingRatingsTargetTypeTargetIdDelete>>, TError, {
+        targetType: SocialTargetEnum;
+        targetId: number;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationResult<Awaited<ReturnType<typeof deleteRatingRatingsTargetTypeTargetIdDelete>>, TError, {
+    targetType: SocialTargetEnum;
+    targetId: number;
+}, TContext>;
+/**
+ * Aggregate {average, count, my_rating} + recent reviews with their
+photos. 404 for targets I cannot see (§12 go-private rule).
+ * @summary Get Rating Aggregate
+ */
+export declare const getRatingAggregateRatingsTargetTypeTargetIdGet: (targetType: SocialTargetEnum, targetId: number, options?: AxiosRequestConfig) => Promise<AxiosResponse<RatingAggregateResponse>>;
+export declare const getGetRatingAggregateRatingsTargetTypeTargetIdGetQueryKey: (targetType?: SocialTargetEnum, targetId?: number) => readonly ["/ratings/undefined/undefined" | `/ratings/undefined/${number}` | "/ratings/recipe/undefined" | `/ratings/recipe/${number}` | "/ratings/meal_plan/undefined" | `/ratings/meal_plan/${number}`];
+export declare const getGetRatingAggregateRatingsTargetTypeTargetIdGetQueryOptions: <TData = Awaited<ReturnType<typeof getRatingAggregateRatingsTargetTypeTargetIdGet>>, TError = AxiosError<HTTPValidationError>>(targetType: SocialTargetEnum, targetId: number, options?: {
+    query?: UseQueryOptions<Awaited<ReturnType<typeof getRatingAggregateRatingsTargetTypeTargetIdGet>>, TError, TData>;
+    axios?: AxiosRequestConfig;
+}) => UseQueryOptions<Awaited<ReturnType<typeof getRatingAggregateRatingsTargetTypeTargetIdGet>>, TError, TData> & {
+    queryKey: QueryKey;
+};
+export type GetRatingAggregateRatingsTargetTypeTargetIdGetQueryResult = NonNullable<Awaited<ReturnType<typeof getRatingAggregateRatingsTargetTypeTargetIdGet>>>;
+export type GetRatingAggregateRatingsTargetTypeTargetIdGetQueryError = AxiosError<HTTPValidationError>;
+/**
+ * @summary Get Rating Aggregate
+ */
+export declare function useGetRatingAggregateRatingsTargetTypeTargetIdGet<TData = Awaited<ReturnType<typeof getRatingAggregateRatingsTargetTypeTargetIdGet>>, TError = AxiosError<HTTPValidationError>>(targetType: SocialTargetEnum, targetId: number, options?: {
+    query?: UseQueryOptions<Awaited<ReturnType<typeof getRatingAggregateRatingsTargetTypeTargetIdGet>>, TError, TData>;
+    axios?: AxiosRequestConfig;
+}): UseQueryResult<TData, TError> & {
+    queryKey: QueryKey;
+};
+/**
+ * Attach a photo to MY review on the target (D3 cook-along photos:
+optional ``step_index`` for the instruction step + optional caption).
+Uses the existing storage MIME/size validation (400/413).
+ * @summary Add Rating Photo
+ */
+export declare const addRatingPhotoRatingsTargetTypeTargetIdPhotosPost: (targetType: SocialTargetEnum, targetId: number, bodyAddRatingPhotoRatingsTargetTypeTargetIdPhotosPost: BodyAddRatingPhotoRatingsTargetTypeTargetIdPhotosPost, options?: AxiosRequestConfig) => Promise<AxiosResponse<RatingPhotoResponse>>;
+export declare const getAddRatingPhotoRatingsTargetTypeTargetIdPhotosPostMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof addRatingPhotoRatingsTargetTypeTargetIdPhotosPost>>, TError, {
+        targetType: SocialTargetEnum;
+        targetId: number;
+        data: BodyAddRatingPhotoRatingsTargetTypeTargetIdPhotosPost;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationOptions<Awaited<ReturnType<typeof addRatingPhotoRatingsTargetTypeTargetIdPhotosPost>>, TError, {
+    targetType: SocialTargetEnum;
+    targetId: number;
+    data: BodyAddRatingPhotoRatingsTargetTypeTargetIdPhotosPost;
+}, TContext>;
+export type AddRatingPhotoRatingsTargetTypeTargetIdPhotosPostMutationResult = NonNullable<Awaited<ReturnType<typeof addRatingPhotoRatingsTargetTypeTargetIdPhotosPost>>>;
+export type AddRatingPhotoRatingsTargetTypeTargetIdPhotosPostMutationBody = BodyAddRatingPhotoRatingsTargetTypeTargetIdPhotosPost;
+export type AddRatingPhotoRatingsTargetTypeTargetIdPhotosPostMutationError = AxiosError<HTTPValidationError>;
+/**
+* @summary Add Rating Photo
+*/
+export declare const useAddRatingPhotoRatingsTargetTypeTargetIdPhotosPost: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof addRatingPhotoRatingsTargetTypeTargetIdPhotosPost>>, TError, {
+        targetType: SocialTargetEnum;
+        targetId: number;
+        data: BodyAddRatingPhotoRatingsTargetTypeTargetIdPhotosPost;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationResult<Awaited<ReturnType<typeof addRatingPhotoRatingsTargetTypeTargetIdPhotosPost>>, TError, {
+    targetType: SocialTargetEnum;
+    targetId: number;
+    data: BodyAddRatingPhotoRatingsTargetTypeTargetIdPhotosPost;
+}, TContext>;
+/**
+ * @summary Get Recipe Image
+ */
+export declare const getRecipeImageRecipesRecipeImageFilenameGet: (filename: string, options?: AxiosRequestConfig) => Promise<AxiosResponse<unknown>>;
+export declare const getGetRecipeImageRecipesRecipeImageFilenameGetQueryKey: (filename?: string) => readonly [`/recipes/recipe-image/${string}`];
+export declare const getGetRecipeImageRecipesRecipeImageFilenameGetQueryOptions: <TData = Awaited<ReturnType<typeof getRecipeImageRecipesRecipeImageFilenameGet>>, TError = AxiosError<HTTPValidationError>>(filename: string, options?: {
+    query?: UseQueryOptions<Awaited<ReturnType<typeof getRecipeImageRecipesRecipeImageFilenameGet>>, TError, TData>;
+    axios?: AxiosRequestConfig;
+}) => UseQueryOptions<Awaited<ReturnType<typeof getRecipeImageRecipesRecipeImageFilenameGet>>, TError, TData> & {
+    queryKey: QueryKey;
+};
+export type GetRecipeImageRecipesRecipeImageFilenameGetQueryResult = NonNullable<Awaited<ReturnType<typeof getRecipeImageRecipesRecipeImageFilenameGet>>>;
+export type GetRecipeImageRecipesRecipeImageFilenameGetQueryError = AxiosError<HTTPValidationError>;
+/**
+ * @summary Get Recipe Image
+ */
+export declare function useGetRecipeImageRecipesRecipeImageFilenameGet<TData = Awaited<ReturnType<typeof getRecipeImageRecipesRecipeImageFilenameGet>>, TError = AxiosError<HTTPValidationError>>(filename: string, options?: {
+    query?: UseQueryOptions<Awaited<ReturnType<typeof getRecipeImageRecipesRecipeImageFilenameGet>>, TError, TData>;
+    axios?: AxiosRequestConfig;
+}): UseQueryResult<TData, TError> & {
+    queryKey: QueryKey;
+};
+/**
+ * @summary Search Pantry Items
+ */
+export declare const searchPantryItemsRecipesPantrySearchGet: (params: SearchPantryItemsRecipesPantrySearchGetParams, options?: AxiosRequestConfig) => Promise<AxiosResponse<SearchPantryItemsRecipesPantrySearchGet200>>;
+export declare const getSearchPantryItemsRecipesPantrySearchGetQueryKey: (params?: SearchPantryItemsRecipesPantrySearchGetParams) => readonly ["/recipes/pantry/search", ...SearchPantryItemsRecipesPantrySearchGetParams[]];
+export declare const getSearchPantryItemsRecipesPantrySearchGetQueryOptions: <TData = Awaited<ReturnType<typeof searchPantryItemsRecipesPantrySearchGet>>, TError = AxiosError<HTTPValidationError>>(params: SearchPantryItemsRecipesPantrySearchGetParams, options?: {
+    query?: UseQueryOptions<Awaited<ReturnType<typeof searchPantryItemsRecipesPantrySearchGet>>, TError, TData>;
+    axios?: AxiosRequestConfig;
+}) => UseQueryOptions<Awaited<ReturnType<typeof searchPantryItemsRecipesPantrySearchGet>>, TError, TData> & {
+    queryKey: QueryKey;
+};
+export type SearchPantryItemsRecipesPantrySearchGetQueryResult = NonNullable<Awaited<ReturnType<typeof searchPantryItemsRecipesPantrySearchGet>>>;
+export type SearchPantryItemsRecipesPantrySearchGetQueryError = AxiosError<HTTPValidationError>;
+/**
+ * @summary Search Pantry Items
+ */
+export declare function useSearchPantryItemsRecipesPantrySearchGet<TData = Awaited<ReturnType<typeof searchPantryItemsRecipesPantrySearchGet>>, TError = AxiosError<HTTPValidationError>>(params: SearchPantryItemsRecipesPantrySearchGetParams, options?: {
+    query?: UseQueryOptions<Awaited<ReturnType<typeof searchPantryItemsRecipesPantrySearchGet>>, TError, TData>;
+    axios?: AxiosRequestConfig;
+}): UseQueryResult<TData, TError> & {
+    queryKey: QueryKey;
+};
+/**
+ * @summary Create Recipe
+ */
+export declare const createRecipeRecipesPost: (bodyCreateRecipeRecipesPost: BodyCreateRecipeRecipesPost, options?: AxiosRequestConfig) => Promise<AxiosResponse<RecipeResponse>>;
+export declare const getCreateRecipeRecipesPostMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof createRecipeRecipesPost>>, TError, {
+        data: BodyCreateRecipeRecipesPost;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationOptions<Awaited<ReturnType<typeof createRecipeRecipesPost>>, TError, {
+    data: BodyCreateRecipeRecipesPost;
+}, TContext>;
+export type CreateRecipeRecipesPostMutationResult = NonNullable<Awaited<ReturnType<typeof createRecipeRecipesPost>>>;
+export type CreateRecipeRecipesPostMutationBody = BodyCreateRecipeRecipesPost;
+export type CreateRecipeRecipesPostMutationError = AxiosError<HTTPValidationError>;
+/**
+* @summary Create Recipe
+*/
+export declare const useCreateRecipeRecipesPost: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof createRecipeRecipesPost>>, TError, {
+        data: BodyCreateRecipeRecipesPost;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationResult<Awaited<ReturnType<typeof createRecipeRecipesPost>>, TError, {
+    data: BodyCreateRecipeRecipesPost;
+}, TContext>;
+/**
+ * @summary Get Recipes
+ */
+export declare const getRecipesRecipesGet: (params?: GetRecipesRecipesGetParams, options?: AxiosRequestConfig) => Promise<AxiosResponse<RecipeResponse[]>>;
+export declare const getGetRecipesRecipesGetQueryKey: (params?: GetRecipesRecipesGetParams) => readonly ["/recipes/", ...GetRecipesRecipesGetParams[]];
+export declare const getGetRecipesRecipesGetQueryOptions: <TData = Awaited<ReturnType<typeof getRecipesRecipesGet>>, TError = AxiosError<HTTPValidationError>>(params?: GetRecipesRecipesGetParams, options?: {
+    query?: UseQueryOptions<Awaited<ReturnType<typeof getRecipesRecipesGet>>, TError, TData>;
+    axios?: AxiosRequestConfig;
+}) => UseQueryOptions<Awaited<ReturnType<typeof getRecipesRecipesGet>>, TError, TData> & {
+    queryKey: QueryKey;
+};
+export type GetRecipesRecipesGetQueryResult = NonNullable<Awaited<ReturnType<typeof getRecipesRecipesGet>>>;
+export type GetRecipesRecipesGetQueryError = AxiosError<HTTPValidationError>;
+/**
+ * @summary Get Recipes
+ */
+export declare function useGetRecipesRecipesGet<TData = Awaited<ReturnType<typeof getRecipesRecipesGet>>, TError = AxiosError<HTTPValidationError>>(params?: GetRecipesRecipesGetParams, options?: {
+    query?: UseQueryOptions<Awaited<ReturnType<typeof getRecipesRecipesGet>>, TError, TData>;
+    axios?: AxiosRequestConfig;
+}): UseQueryResult<TData, TError> & {
+    queryKey: QueryKey;
+};
+/**
+ * Deterministic 'what can I cook' — coverage ranking over the catalog
+and the household's own recipes against its pantry (blueprint §5.3).
+Pure SQL, no LLM; this is also the no-LLM degraded path behind
+/ai/suggest-recipes (§9.1).
+ * @summary Get Recipe Suggestions
+ */
+export declare const getRecipeSuggestionsRecipesSuggestionsGet: (params?: GetRecipeSuggestionsRecipesSuggestionsGetParams, options?: AxiosRequestConfig) => Promise<AxiosResponse<RecipeSuggestion[]>>;
+export declare const getGetRecipeSuggestionsRecipesSuggestionsGetQueryKey: (params?: GetRecipeSuggestionsRecipesSuggestionsGetParams) => readonly ["/recipes/suggestions", ...GetRecipeSuggestionsRecipesSuggestionsGetParams[]];
+export declare const getGetRecipeSuggestionsRecipesSuggestionsGetQueryOptions: <TData = Awaited<ReturnType<typeof getRecipeSuggestionsRecipesSuggestionsGet>>, TError = AxiosError<HTTPValidationError>>(params?: GetRecipeSuggestionsRecipesSuggestionsGetParams, options?: {
+    query?: UseQueryOptions<Awaited<ReturnType<typeof getRecipeSuggestionsRecipesSuggestionsGet>>, TError, TData>;
+    axios?: AxiosRequestConfig;
+}) => UseQueryOptions<Awaited<ReturnType<typeof getRecipeSuggestionsRecipesSuggestionsGet>>, TError, TData> & {
+    queryKey: QueryKey;
+};
+export type GetRecipeSuggestionsRecipesSuggestionsGetQueryResult = NonNullable<Awaited<ReturnType<typeof getRecipeSuggestionsRecipesSuggestionsGet>>>;
+export type GetRecipeSuggestionsRecipesSuggestionsGetQueryError = AxiosError<HTTPValidationError>;
+/**
+ * @summary Get Recipe Suggestions
+ */
+export declare function useGetRecipeSuggestionsRecipesSuggestionsGet<TData = Awaited<ReturnType<typeof getRecipeSuggestionsRecipesSuggestionsGet>>, TError = AxiosError<HTTPValidationError>>(params?: GetRecipeSuggestionsRecipesSuggestionsGetParams, options?: {
+    query?: UseQueryOptions<Awaited<ReturnType<typeof getRecipeSuggestionsRecipesSuggestionsGet>>, TError, TData>;
+    axios?: AxiosRequestConfig;
+}): UseQueryResult<TData, TError> & {
+    queryKey: QueryKey;
+};
+/**
+ * @summary Get Recipe
+ */
+export declare const getRecipeRecipesRecipeIdGet: (recipeId: number, options?: AxiosRequestConfig) => Promise<AxiosResponse<RecipeResponse>>;
+export declare const getGetRecipeRecipesRecipeIdGetQueryKey: (recipeId?: number) => readonly ["/recipes/undefined" | `/recipes/${number}`];
+export declare const getGetRecipeRecipesRecipeIdGetQueryOptions: <TData = Awaited<ReturnType<typeof getRecipeRecipesRecipeIdGet>>, TError = AxiosError<HTTPValidationError>>(recipeId: number, options?: {
+    query?: UseQueryOptions<Awaited<ReturnType<typeof getRecipeRecipesRecipeIdGet>>, TError, TData>;
+    axios?: AxiosRequestConfig;
+}) => UseQueryOptions<Awaited<ReturnType<typeof getRecipeRecipesRecipeIdGet>>, TError, TData> & {
+    queryKey: QueryKey;
+};
+export type GetRecipeRecipesRecipeIdGetQueryResult = NonNullable<Awaited<ReturnType<typeof getRecipeRecipesRecipeIdGet>>>;
+export type GetRecipeRecipesRecipeIdGetQueryError = AxiosError<HTTPValidationError>;
+/**
+ * @summary Get Recipe
+ */
+export declare function useGetRecipeRecipesRecipeIdGet<TData = Awaited<ReturnType<typeof getRecipeRecipesRecipeIdGet>>, TError = AxiosError<HTTPValidationError>>(recipeId: number, options?: {
+    query?: UseQueryOptions<Awaited<ReturnType<typeof getRecipeRecipesRecipeIdGet>>, TError, TData>;
+    axios?: AxiosRequestConfig;
+}): UseQueryResult<TData, TError> & {
+    queryKey: QueryKey;
+};
+/**
+ * @summary Update Recipe
+ */
+export declare const updateRecipeRecipesRecipeIdPut: (recipeId: number, bodyUpdateRecipeRecipesRecipeIdPut: BodyUpdateRecipeRecipesRecipeIdPut, options?: AxiosRequestConfig) => Promise<AxiosResponse<RecipeResponse>>;
+export declare const getUpdateRecipeRecipesRecipeIdPutMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof updateRecipeRecipesRecipeIdPut>>, TError, {
+        recipeId: number;
+        data: BodyUpdateRecipeRecipesRecipeIdPut;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationOptions<Awaited<ReturnType<typeof updateRecipeRecipesRecipeIdPut>>, TError, {
+    recipeId: number;
+    data: BodyUpdateRecipeRecipesRecipeIdPut;
+}, TContext>;
+export type UpdateRecipeRecipesRecipeIdPutMutationResult = NonNullable<Awaited<ReturnType<typeof updateRecipeRecipesRecipeIdPut>>>;
+export type UpdateRecipeRecipesRecipeIdPutMutationBody = BodyUpdateRecipeRecipesRecipeIdPut;
+export type UpdateRecipeRecipesRecipeIdPutMutationError = AxiosError<HTTPValidationError>;
+/**
+* @summary Update Recipe
+*/
+export declare const useUpdateRecipeRecipesRecipeIdPut: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof updateRecipeRecipesRecipeIdPut>>, TError, {
+        recipeId: number;
+        data: BodyUpdateRecipeRecipesRecipeIdPut;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationResult<Awaited<ReturnType<typeof updateRecipeRecipesRecipeIdPut>>, TError, {
+    recipeId: number;
+    data: BodyUpdateRecipeRecipesRecipeIdPut;
+}, TContext>;
+/**
+ * @summary Delete Recipe
+ */
+export declare const deleteRecipeRecipesRecipeIdDelete: (recipeId: number, options?: AxiosRequestConfig) => Promise<AxiosResponse<DeleteRecipeRecipesRecipeIdDelete200>>;
+export declare const getDeleteRecipeRecipesRecipeIdDeleteMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof deleteRecipeRecipesRecipeIdDelete>>, TError, {
+        recipeId: number;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationOptions<Awaited<ReturnType<typeof deleteRecipeRecipesRecipeIdDelete>>, TError, {
+    recipeId: number;
+}, TContext>;
+export type DeleteRecipeRecipesRecipeIdDeleteMutationResult = NonNullable<Awaited<ReturnType<typeof deleteRecipeRecipesRecipeIdDelete>>>;
+export type DeleteRecipeRecipesRecipeIdDeleteMutationError = AxiosError<HTTPValidationError>;
+/**
+* @summary Delete Recipe
+*/
+export declare const useDeleteRecipeRecipesRecipeIdDelete: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof deleteRecipeRecipesRecipeIdDelete>>, TError, {
+        recipeId: number;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationResult<Awaited<ReturnType<typeof deleteRecipeRecipesRecipeIdDelete>>, TError, {
+    recipeId: number;
+}, TContext>;
+/**
+ * One-tap gap fill: bulk-add this recipe's missing ingredients to a
+shopping list (defaults to the household's active list — §5.3).
+ * @summary Add Missing To List
+ */
+export declare const addMissingToListRecipesRecipeIdAddMissingToListPost: (recipeId: number, addMissingRequest: AddMissingRequest, options?: AxiosRequestConfig) => Promise<AxiosResponse<AddMissingResponse>>;
+export declare const getAddMissingToListRecipesRecipeIdAddMissingToListPostMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof addMissingToListRecipesRecipeIdAddMissingToListPost>>, TError, {
+        recipeId: number;
+        data: AddMissingRequest;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationOptions<Awaited<ReturnType<typeof addMissingToListRecipesRecipeIdAddMissingToListPost>>, TError, {
+    recipeId: number;
+    data: AddMissingRequest;
+}, TContext>;
+export type AddMissingToListRecipesRecipeIdAddMissingToListPostMutationResult = NonNullable<Awaited<ReturnType<typeof addMissingToListRecipesRecipeIdAddMissingToListPost>>>;
+export type AddMissingToListRecipesRecipeIdAddMissingToListPostMutationBody = AddMissingRequest;
+export type AddMissingToListRecipesRecipeIdAddMissingToListPostMutationError = AxiosError<HTTPValidationError>;
+/**
+* @summary Add Missing To List
+*/
+export declare const useAddMissingToListRecipesRecipeIdAddMissingToListPost: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof addMissingToListRecipesRecipeIdAddMissingToListPost>>, TError, {
+        recipeId: number;
+        data: AddMissingRequest;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationResult<Awaited<ReturnType<typeof addMissingToListRecipesRecipeIdAddMissingToListPost>>, TError, {
+    recipeId: number;
+    data: AddMissingRequest;
+}, TContext>;
+/**
+ * List/search canonical ingredients (autocomplete source).
+ * @summary List Ingredients
+ */
+export declare const listIngredientsCatalogIngredientsGet: (params?: ListIngredientsCatalogIngredientsGetParams, options?: AxiosRequestConfig) => Promise<AxiosResponse<CatalogIngredientSummary[]>>;
+export declare const getListIngredientsCatalogIngredientsGetQueryKey: (params?: ListIngredientsCatalogIngredientsGetParams) => readonly ["/catalog/ingredients/", ...ListIngredientsCatalogIngredientsGetParams[]];
+export declare const getListIngredientsCatalogIngredientsGetQueryOptions: <TData = Awaited<ReturnType<typeof listIngredientsCatalogIngredientsGet>>, TError = AxiosError<HTTPValidationError>>(params?: ListIngredientsCatalogIngredientsGetParams, options?: {
+    query?: UseQueryOptions<Awaited<ReturnType<typeof listIngredientsCatalogIngredientsGet>>, TError, TData>;
+    axios?: AxiosRequestConfig;
+}) => UseQueryOptions<Awaited<ReturnType<typeof listIngredientsCatalogIngredientsGet>>, TError, TData> & {
+    queryKey: QueryKey;
+};
+export type ListIngredientsCatalogIngredientsGetQueryResult = NonNullable<Awaited<ReturnType<typeof listIngredientsCatalogIngredientsGet>>>;
+export type ListIngredientsCatalogIngredientsGetQueryError = AxiosError<HTTPValidationError>;
+/**
+ * @summary List Ingredients
+ */
+export declare function useListIngredientsCatalogIngredientsGet<TData = Awaited<ReturnType<typeof listIngredientsCatalogIngredientsGet>>, TError = AxiosError<HTTPValidationError>>(params?: ListIngredientsCatalogIngredientsGetParams, options?: {
+    query?: UseQueryOptions<Awaited<ReturnType<typeof listIngredientsCatalogIngredientsGet>>, TError, TData>;
+    axios?: AxiosRequestConfig;
+}): UseQueryResult<TData, TError> & {
+    queryKey: QueryKey;
+};
+/**
+ * One ingredient with its aliases and substitution edges.
+ * @summary Get Ingredient
+ */
+export declare const getIngredientCatalogIngredientsIngredientIdGet: (ingredientId: number, options?: AxiosRequestConfig) => Promise<AxiosResponse<CatalogIngredientDetail>>;
+export declare const getGetIngredientCatalogIngredientsIngredientIdGetQueryKey: (ingredientId?: number) => readonly ["/catalog/ingredients/undefined" | `/catalog/ingredients/${number}`];
+export declare const getGetIngredientCatalogIngredientsIngredientIdGetQueryOptions: <TData = Awaited<ReturnType<typeof getIngredientCatalogIngredientsIngredientIdGet>>, TError = AxiosError<HTTPValidationError>>(ingredientId: number, options?: {
+    query?: UseQueryOptions<Awaited<ReturnType<typeof getIngredientCatalogIngredientsIngredientIdGet>>, TError, TData>;
+    axios?: AxiosRequestConfig;
+}) => UseQueryOptions<Awaited<ReturnType<typeof getIngredientCatalogIngredientsIngredientIdGet>>, TError, TData> & {
+    queryKey: QueryKey;
+};
+export type GetIngredientCatalogIngredientsIngredientIdGetQueryResult = NonNullable<Awaited<ReturnType<typeof getIngredientCatalogIngredientsIngredientIdGet>>>;
+export type GetIngredientCatalogIngredientsIngredientIdGetQueryError = AxiosError<HTTPValidationError>;
+/**
+ * @summary Get Ingredient
+ */
+export declare function useGetIngredientCatalogIngredientsIngredientIdGet<TData = Awaited<ReturnType<typeof getIngredientCatalogIngredientsIngredientIdGet>>, TError = AxiosError<HTTPValidationError>>(ingredientId: number, options?: {
+    query?: UseQueryOptions<Awaited<ReturnType<typeof getIngredientCatalogIngredientsIngredientIdGet>>, TError, TData>;
+    axios?: AxiosRequestConfig;
+}): UseQueryResult<TData, TError> & {
+    queryKey: QueryKey;
+};
+/**
+ * List catalog tags, optionally filtered by kind (cuisine|diet|course|meal_type).
+ * @summary List Tags
+ */
+export declare const listTagsCatalogTagsGet: (params?: ListTagsCatalogTagsGetParams, options?: AxiosRequestConfig) => Promise<AxiosResponse<CatalogTagOut[]>>;
+export declare const getListTagsCatalogTagsGetQueryKey: (params?: ListTagsCatalogTagsGetParams) => readonly ["/catalog/tags/", ...ListTagsCatalogTagsGetParams[]];
+export declare const getListTagsCatalogTagsGetQueryOptions: <TData = Awaited<ReturnType<typeof listTagsCatalogTagsGet>>, TError = AxiosError<HTTPValidationError>>(params?: ListTagsCatalogTagsGetParams, options?: {
+    query?: UseQueryOptions<Awaited<ReturnType<typeof listTagsCatalogTagsGet>>, TError, TData>;
+    axios?: AxiosRequestConfig;
+}) => UseQueryOptions<Awaited<ReturnType<typeof listTagsCatalogTagsGet>>, TError, TData> & {
+    queryKey: QueryKey;
+};
+export type ListTagsCatalogTagsGetQueryResult = NonNullable<Awaited<ReturnType<typeof listTagsCatalogTagsGet>>>;
+export type ListTagsCatalogTagsGetQueryError = AxiosError<HTTPValidationError>;
+/**
+ * @summary List Tags
+ */
+export declare function useListTagsCatalogTagsGet<TData = Awaited<ReturnType<typeof listTagsCatalogTagsGet>>, TError = AxiosError<HTTPValidationError>>(params?: ListTagsCatalogTagsGetParams, options?: {
+    query?: UseQueryOptions<Awaited<ReturnType<typeof listTagsCatalogTagsGet>>, TError, TData>;
+    axios?: AxiosRequestConfig;
+}): UseQueryResult<TData, TError> & {
+    queryKey: QueryKey;
+};
+/**
+ * Browse the recipe catalog with coverage-aware filters.
+ * @summary List Catalog Recipes
+ */
+export declare const listCatalogRecipesCatalogRecipesGet: (params?: ListCatalogRecipesCatalogRecipesGetParams, options?: AxiosRequestConfig) => Promise<AxiosResponse<CatalogRecipeSummary[]>>;
+export declare const getListCatalogRecipesCatalogRecipesGetQueryKey: (params?: ListCatalogRecipesCatalogRecipesGetParams) => readonly ["/catalog/recipes/", ...ListCatalogRecipesCatalogRecipesGetParams[]];
+export declare const getListCatalogRecipesCatalogRecipesGetQueryOptions: <TData = Awaited<ReturnType<typeof listCatalogRecipesCatalogRecipesGet>>, TError = AxiosError<HTTPValidationError>>(params?: ListCatalogRecipesCatalogRecipesGetParams, options?: {
+    query?: UseQueryOptions<Awaited<ReturnType<typeof listCatalogRecipesCatalogRecipesGet>>, TError, TData>;
+    axios?: AxiosRequestConfig;
+}) => UseQueryOptions<Awaited<ReturnType<typeof listCatalogRecipesCatalogRecipesGet>>, TError, TData> & {
+    queryKey: QueryKey;
+};
+export type ListCatalogRecipesCatalogRecipesGetQueryResult = NonNullable<Awaited<ReturnType<typeof listCatalogRecipesCatalogRecipesGet>>>;
+export type ListCatalogRecipesCatalogRecipesGetQueryError = AxiosError<HTTPValidationError>;
+/**
+ * @summary List Catalog Recipes
+ */
+export declare function useListCatalogRecipesCatalogRecipesGet<TData = Awaited<ReturnType<typeof listCatalogRecipesCatalogRecipesGet>>, TError = AxiosError<HTTPValidationError>>(params?: ListCatalogRecipesCatalogRecipesGetParams, options?: {
+    query?: UseQueryOptions<Awaited<ReturnType<typeof listCatalogRecipesCatalogRecipesGet>>, TError, TData>;
+    axios?: AxiosRequestConfig;
+}): UseQueryResult<TData, TError> & {
+    queryKey: QueryKey;
+};
+/**
+ * Full catalog recipe: linked ingredients, steps, tags, source.
+ * @summary Get Catalog Recipe
+ */
+export declare const getCatalogRecipeCatalogRecipesRecipeIdGet: (recipeId: number, options?: AxiosRequestConfig) => Promise<AxiosResponse<CatalogRecipeDetail>>;
+export declare const getGetCatalogRecipeCatalogRecipesRecipeIdGetQueryKey: (recipeId?: number) => readonly ["/catalog/recipes/undefined" | `/catalog/recipes/${number}`];
+export declare const getGetCatalogRecipeCatalogRecipesRecipeIdGetQueryOptions: <TData = Awaited<ReturnType<typeof getCatalogRecipeCatalogRecipesRecipeIdGet>>, TError = AxiosError<HTTPValidationError>>(recipeId: number, options?: {
+    query?: UseQueryOptions<Awaited<ReturnType<typeof getCatalogRecipeCatalogRecipesRecipeIdGet>>, TError, TData>;
+    axios?: AxiosRequestConfig;
+}) => UseQueryOptions<Awaited<ReturnType<typeof getCatalogRecipeCatalogRecipesRecipeIdGet>>, TError, TData> & {
+    queryKey: QueryKey;
+};
+export type GetCatalogRecipeCatalogRecipesRecipeIdGetQueryResult = NonNullable<Awaited<ReturnType<typeof getCatalogRecipeCatalogRecipesRecipeIdGet>>>;
+export type GetCatalogRecipeCatalogRecipesRecipeIdGetQueryError = AxiosError<HTTPValidationError>;
+/**
+ * @summary Get Catalog Recipe
+ */
+export declare function useGetCatalogRecipeCatalogRecipesRecipeIdGet<TData = Awaited<ReturnType<typeof getCatalogRecipeCatalogRecipesRecipeIdGet>>, TError = AxiosError<HTTPValidationError>>(recipeId: number, options?: {
+    query?: UseQueryOptions<Awaited<ReturnType<typeof getCatalogRecipeCatalogRecipesRecipeIdGet>>, TError, TData>;
+    axios?: AxiosRequestConfig;
+}): UseQueryResult<TData, TError> & {
+    queryKey: QueryKey;
+};
+/**
+ * One-tap gap fill for a catalog recipe (§5.3): bulk-add its missing
+ingredients to a shopping list (defaults to the household's active list).
+ * @summary Add Missing Catalog Recipe To List
+ */
+export declare const addMissingCatalogRecipeToListCatalogRecipesRecipeIdAddMissingToListPost: (recipeId: number, addMissingRequest: AddMissingRequest, options?: AxiosRequestConfig) => Promise<AxiosResponse<AddMissingResponse>>;
+export declare const getAddMissingCatalogRecipeToListCatalogRecipesRecipeIdAddMissingToListPostMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof addMissingCatalogRecipeToListCatalogRecipesRecipeIdAddMissingToListPost>>, TError, {
+        recipeId: number;
+        data: AddMissingRequest;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationOptions<Awaited<ReturnType<typeof addMissingCatalogRecipeToListCatalogRecipesRecipeIdAddMissingToListPost>>, TError, {
+    recipeId: number;
+    data: AddMissingRequest;
+}, TContext>;
+export type AddMissingCatalogRecipeToListCatalogRecipesRecipeIdAddMissingToListPostMutationResult = NonNullable<Awaited<ReturnType<typeof addMissingCatalogRecipeToListCatalogRecipesRecipeIdAddMissingToListPost>>>;
+export type AddMissingCatalogRecipeToListCatalogRecipesRecipeIdAddMissingToListPostMutationBody = AddMissingRequest;
+export type AddMissingCatalogRecipeToListCatalogRecipesRecipeIdAddMissingToListPostMutationError = AxiosError<HTTPValidationError>;
+/**
+* @summary Add Missing Catalog Recipe To List
+*/
+export declare const useAddMissingCatalogRecipeToListCatalogRecipesRecipeIdAddMissingToListPost: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof addMissingCatalogRecipeToListCatalogRecipesRecipeIdAddMissingToListPost>>, TError, {
+        recipeId: number;
+        data: AddMissingRequest;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationResult<Awaited<ReturnType<typeof addMissingCatalogRecipeToListCatalogRecipesRecipeIdAddMissingToListPost>>, TError, {
+    recipeId: number;
+    data: AddMissingRequest;
+}, TContext>;
+/**
+ * Copy a catalog recipe into the caller's library (provenance set).
+
+This is also the persist-on-save path for grounded AI suggestions
+(blueprint §9.1 Stage 3).
+ * @summary Save Catalog Recipe
+ */
+export declare const saveCatalogRecipeCatalogRecipesRecipeIdSavePost: (recipeId: number, options?: AxiosRequestConfig) => Promise<AxiosResponse<RecipeResponse>>;
+export declare const getSaveCatalogRecipeCatalogRecipesRecipeIdSavePostMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof saveCatalogRecipeCatalogRecipesRecipeIdSavePost>>, TError, {
+        recipeId: number;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationOptions<Awaited<ReturnType<typeof saveCatalogRecipeCatalogRecipesRecipeIdSavePost>>, TError, {
+    recipeId: number;
+}, TContext>;
+export type SaveCatalogRecipeCatalogRecipesRecipeIdSavePostMutationResult = NonNullable<Awaited<ReturnType<typeof saveCatalogRecipeCatalogRecipesRecipeIdSavePost>>>;
+export type SaveCatalogRecipeCatalogRecipesRecipeIdSavePostMutationError = AxiosError<HTTPValidationError>;
+/**
+* @summary Save Catalog Recipe
+*/
+export declare const useSaveCatalogRecipeCatalogRecipesRecipeIdSavePost: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof saveCatalogRecipeCatalogRecipesRecipeIdSavePost>>, TError, {
+        recipeId: number;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationResult<Awaited<ReturnType<typeof saveCatalogRecipeCatalogRecipesRecipeIdSavePost>>, TError, {
+    recipeId: number;
+}, TContext>;
+/**
+ * Ranked name completions: household history first, then catalog
+prefix/substring/fuzzy, catalog tiers ordered by global linked usage.
+ * @summary Autocomplete Ingredients
+ */
+export declare const autocompleteIngredientsIngredientsAutocompleteGet: (params: AutocompleteIngredientsIngredientsAutocompleteGetParams, options?: AxiosRequestConfig) => Promise<AxiosResponse<IngredientAutocompleteItem[]>>;
+export declare const getAutocompleteIngredientsIngredientsAutocompleteGetQueryKey: (params?: AutocompleteIngredientsIngredientsAutocompleteGetParams) => readonly ["/ingredients/autocomplete", ...AutocompleteIngredientsIngredientsAutocompleteGetParams[]];
+export declare const getAutocompleteIngredientsIngredientsAutocompleteGetQueryOptions: <TData = Awaited<ReturnType<typeof autocompleteIngredientsIngredientsAutocompleteGet>>, TError = AxiosError<HTTPValidationError>>(params: AutocompleteIngredientsIngredientsAutocompleteGetParams, options?: {
+    query?: UseQueryOptions<Awaited<ReturnType<typeof autocompleteIngredientsIngredientsAutocompleteGet>>, TError, TData>;
+    axios?: AxiosRequestConfig;
+}) => UseQueryOptions<Awaited<ReturnType<typeof autocompleteIngredientsIngredientsAutocompleteGet>>, TError, TData> & {
+    queryKey: QueryKey;
+};
+export type AutocompleteIngredientsIngredientsAutocompleteGetQueryResult = NonNullable<Awaited<ReturnType<typeof autocompleteIngredientsIngredientsAutocompleteGet>>>;
+export type AutocompleteIngredientsIngredientsAutocompleteGetQueryError = AxiosError<HTTPValidationError>;
+/**
+ * @summary Autocomplete Ingredients
+ */
+export declare function useAutocompleteIngredientsIngredientsAutocompleteGet<TData = Awaited<ReturnType<typeof autocompleteIngredientsIngredientsAutocompleteGet>>, TError = AxiosError<HTTPValidationError>>(params: AutocompleteIngredientsIngredientsAutocompleteGetParams, options?: {
+    query?: UseQueryOptions<Awaited<ReturnType<typeof autocompleteIngredientsIngredientsAutocompleteGet>>, TError, TData>;
+    axios?: AxiosRequestConfig;
+}): UseQueryResult<TData, TError> & {
+    queryKey: QueryKey;
+};
+/**
+ * List the household's plans plus the system presets.
+ * @summary List Plans
+ */
+export declare const listPlansPlansGet: (params?: ListPlansPlansGetParams, options?: AxiosRequestConfig) => Promise<AxiosResponse<MealPlanResponse[]>>;
+export declare const getListPlansPlansGetQueryKey: (params?: ListPlansPlansGetParams) => readonly ["/plans/", ...ListPlansPlansGetParams[]];
+export declare const getListPlansPlansGetQueryOptions: <TData = Awaited<ReturnType<typeof listPlansPlansGet>>, TError = AxiosError<HTTPValidationError>>(params?: ListPlansPlansGetParams, options?: {
+    query?: UseQueryOptions<Awaited<ReturnType<typeof listPlansPlansGet>>, TError, TData>;
+    axios?: AxiosRequestConfig;
+}) => UseQueryOptions<Awaited<ReturnType<typeof listPlansPlansGet>>, TError, TData> & {
+    queryKey: QueryKey;
+};
+export type ListPlansPlansGetQueryResult = NonNullable<Awaited<ReturnType<typeof listPlansPlansGet>>>;
+export type ListPlansPlansGetQueryError = AxiosError<HTTPValidationError>;
+/**
+ * @summary List Plans
+ */
+export declare function useListPlansPlansGet<TData = Awaited<ReturnType<typeof listPlansPlansGet>>, TError = AxiosError<HTTPValidationError>>(params?: ListPlansPlansGetParams, options?: {
+    query?: UseQueryOptions<Awaited<ReturnType<typeof listPlansPlansGet>>, TError, TData>;
+    axios?: AxiosRequestConfig;
+}): UseQueryResult<TData, TError> & {
+    queryKey: QueryKey;
+};
+/**
+ * Create an empty plan, or copy one from a template/preset (template_id).
+ * @summary Create Plan
+ */
+export declare const createPlanPlansPost: (mealPlanCreate: MealPlanCreate, options?: AxiosRequestConfig) => Promise<AxiosResponse<MealPlanDetailResponse>>;
+export declare const getCreatePlanPlansPostMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof createPlanPlansPost>>, TError, {
+        data: MealPlanCreate;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationOptions<Awaited<ReturnType<typeof createPlanPlansPost>>, TError, {
+    data: MealPlanCreate;
+}, TContext>;
+export type CreatePlanPlansPostMutationResult = NonNullable<Awaited<ReturnType<typeof createPlanPlansPost>>>;
+export type CreatePlanPlansPostMutationBody = MealPlanCreate;
+export type CreatePlanPlansPostMutationError = AxiosError<HTTPValidationError>;
+/**
+* @summary Create Plan
+*/
+export declare const useCreatePlanPlansPost: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof createPlanPlansPost>>, TError, {
+        data: MealPlanCreate;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationResult<Awaited<ReturnType<typeof createPlanPlansPost>>, TError, {
+    data: MealPlanCreate;
+}, TContext>;
+/**
+ * Agentic grounded plan generation (§9.2): deterministic retrieval once
+per plan against the household pantry, per-slot filters, LLM assigns
+candidates to slots; persisted as a status=draft plan in one transaction.
+ * @summary Generate Plan
+ */
+export declare const generatePlanPlansGeneratePost: (planGenerateRequest: PlanGenerateRequest, options?: AxiosRequestConfig) => Promise<AxiosResponse<MealPlanGenerateResponse>>;
+export declare const getGeneratePlanPlansGeneratePostMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof generatePlanPlansGeneratePost>>, TError, {
+        data: PlanGenerateRequest;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationOptions<Awaited<ReturnType<typeof generatePlanPlansGeneratePost>>, TError, {
+    data: PlanGenerateRequest;
+}, TContext>;
+export type GeneratePlanPlansGeneratePostMutationResult = NonNullable<Awaited<ReturnType<typeof generatePlanPlansGeneratePost>>>;
+export type GeneratePlanPlansGeneratePostMutationBody = PlanGenerateRequest;
+export type GeneratePlanPlansGeneratePostMutationError = AxiosError<HTTPValidationError>;
+/**
+* @summary Generate Plan
+*/
+export declare const useGeneratePlanPlansGeneratePost: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof generatePlanPlansGeneratePost>>, TError, {
+        data: PlanGenerateRequest;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationResult<Awaited<ReturnType<typeof generatePlanPlansGeneratePost>>, TError, {
+    data: PlanGenerateRequest;
+}, TContext>;
+/**
+ * Copy a system preset into the household (status=draft); optionally
+generate its starter grocery list (§10) in the same transaction.
+ * @summary Adopt Preset
+ */
+export declare const adoptPresetPlansPresetsPresetIdAdoptPost: (presetId: number, params?: AdoptPresetPlansPresetsPresetIdAdoptPostParams, options?: AxiosRequestConfig) => Promise<AxiosResponse<PresetAdoptResponse>>;
+export declare const getAdoptPresetPlansPresetsPresetIdAdoptPostMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof adoptPresetPlansPresetsPresetIdAdoptPost>>, TError, {
+        presetId: number;
+        params?: AdoptPresetPlansPresetsPresetIdAdoptPostParams;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationOptions<Awaited<ReturnType<typeof adoptPresetPlansPresetsPresetIdAdoptPost>>, TError, {
+    presetId: number;
+    params?: AdoptPresetPlansPresetsPresetIdAdoptPostParams;
+}, TContext>;
+export type AdoptPresetPlansPresetsPresetIdAdoptPostMutationResult = NonNullable<Awaited<ReturnType<typeof adoptPresetPlansPresetsPresetIdAdoptPost>>>;
+export type AdoptPresetPlansPresetsPresetIdAdoptPostMutationError = AxiosError<HTTPValidationError>;
+/**
+* @summary Adopt Preset
+*/
+export declare const useAdoptPresetPlansPresetsPresetIdAdoptPost: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof adoptPresetPlansPresetsPresetIdAdoptPost>>, TError, {
+        presetId: number;
+        params?: AdoptPresetPlansPresetsPresetIdAdoptPostParams;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationResult<Awaited<ReturnType<typeof adoptPresetPlansPresetsPresetIdAdoptPost>>, TError, {
+    presetId: number;
+    params?: AdoptPresetPlansPresetsPresetIdAdoptPostParams;
+}, TContext>;
+/**
+ * One plan with its slots (eager-loaded).
+ * @summary Get Plan
+ */
+export declare const getPlanPlansPlanIdGet: (planId: number, options?: AxiosRequestConfig) => Promise<AxiosResponse<MealPlanDetailResponse>>;
+export declare const getGetPlanPlansPlanIdGetQueryKey: (planId?: number) => readonly ["/plans/undefined" | `/plans/${number}`];
+export declare const getGetPlanPlansPlanIdGetQueryOptions: <TData = Awaited<ReturnType<typeof getPlanPlansPlanIdGet>>, TError = AxiosError<HTTPValidationError>>(planId: number, options?: {
+    query?: UseQueryOptions<Awaited<ReturnType<typeof getPlanPlansPlanIdGet>>, TError, TData>;
+    axios?: AxiosRequestConfig;
+}) => UseQueryOptions<Awaited<ReturnType<typeof getPlanPlansPlanIdGet>>, TError, TData> & {
+    queryKey: QueryKey;
+};
+export type GetPlanPlansPlanIdGetQueryResult = NonNullable<Awaited<ReturnType<typeof getPlanPlansPlanIdGet>>>;
+export type GetPlanPlansPlanIdGetQueryError = AxiosError<HTTPValidationError>;
+/**
+ * @summary Get Plan
+ */
+export declare function useGetPlanPlansPlanIdGet<TData = Awaited<ReturnType<typeof getPlanPlansPlanIdGet>>, TError = AxiosError<HTTPValidationError>>(planId: number, options?: {
+    query?: UseQueryOptions<Awaited<ReturnType<typeof getPlanPlansPlanIdGet>>, TError, TData>;
+    axios?: AxiosRequestConfig;
+}): UseQueryResult<TData, TError> & {
+    queryKey: QueryKey;
+};
+/**
+ * Rename / change status / move week_start / change visibility.
+ * @summary Update Plan
+ */
+export declare const updatePlanPlansPlanIdPut: (planId: number, mealPlanUpdate: MealPlanUpdate, options?: AxiosRequestConfig) => Promise<AxiosResponse<MealPlanDetailResponse>>;
+export declare const getUpdatePlanPlansPlanIdPutMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof updatePlanPlansPlanIdPut>>, TError, {
+        planId: number;
+        data: MealPlanUpdate;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationOptions<Awaited<ReturnType<typeof updatePlanPlansPlanIdPut>>, TError, {
+    planId: number;
+    data: MealPlanUpdate;
+}, TContext>;
+export type UpdatePlanPlansPlanIdPutMutationResult = NonNullable<Awaited<ReturnType<typeof updatePlanPlansPlanIdPut>>>;
+export type UpdatePlanPlansPlanIdPutMutationBody = MealPlanUpdate;
+export type UpdatePlanPlansPlanIdPutMutationError = AxiosError<HTTPValidationError>;
+/**
+* @summary Update Plan
+*/
+export declare const useUpdatePlanPlansPlanIdPut: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof updatePlanPlansPlanIdPut>>, TError, {
+        planId: number;
+        data: MealPlanUpdate;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationResult<Awaited<ReturnType<typeof updatePlanPlansPlanIdPut>>, TError, {
+    planId: number;
+    data: MealPlanUpdate;
+}, TContext>;
+/**
+ * @summary Delete Plan
+ */
+export declare const deletePlanPlansPlanIdDelete: (planId: number, options?: AxiosRequestConfig) => Promise<AxiosResponse<DeletePlanPlansPlanIdDelete200>>;
+export declare const getDeletePlanPlansPlanIdDeleteMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof deletePlanPlansPlanIdDelete>>, TError, {
+        planId: number;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationOptions<Awaited<ReturnType<typeof deletePlanPlansPlanIdDelete>>, TError, {
+    planId: number;
+}, TContext>;
+export type DeletePlanPlansPlanIdDeleteMutationResult = NonNullable<Awaited<ReturnType<typeof deletePlanPlansPlanIdDelete>>>;
+export type DeletePlanPlansPlanIdDeleteMutationError = AxiosError<HTTPValidationError>;
+/**
+* @summary Delete Plan
+*/
+export declare const useDeletePlanPlansPlanIdDelete: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof deletePlanPlansPlanIdDelete>>, TError, {
+        planId: number;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationResult<Awaited<ReturnType<typeof deletePlanPlansPlanIdDelete>>, TError, {
+    planId: number;
+}, TContext>;
+/**
+ * The plan editor's workhorse (§5.5): create/update/delete slot cells
+with per-item results. Items without id create; with id update (or delete
+with _delete=true).
+ * @summary Bulk Update Slots
+ */
+export declare const bulkUpdateSlotsPlansPlanIdSlotsBulkPatch: (planId: number, planSlotBulkRequest: PlanSlotBulkRequest, options?: AxiosRequestConfig) => Promise<AxiosResponse<BulkResponse>>;
+export declare const getBulkUpdateSlotsPlansPlanIdSlotsBulkPatchMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof bulkUpdateSlotsPlansPlanIdSlotsBulkPatch>>, TError, {
+        planId: number;
+        data: PlanSlotBulkRequest;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationOptions<Awaited<ReturnType<typeof bulkUpdateSlotsPlansPlanIdSlotsBulkPatch>>, TError, {
+    planId: number;
+    data: PlanSlotBulkRequest;
+}, TContext>;
+export type BulkUpdateSlotsPlansPlanIdSlotsBulkPatchMutationResult = NonNullable<Awaited<ReturnType<typeof bulkUpdateSlotsPlansPlanIdSlotsBulkPatch>>>;
+export type BulkUpdateSlotsPlansPlanIdSlotsBulkPatchMutationBody = PlanSlotBulkRequest;
+export type BulkUpdateSlotsPlansPlanIdSlotsBulkPatchMutationError = AxiosError<HTTPValidationError>;
+/**
+* @summary Bulk Update Slots
+*/
+export declare const useBulkUpdateSlotsPlansPlanIdSlotsBulkPatch: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof bulkUpdateSlotsPlansPlanIdSlotsBulkPatch>>, TError, {
+        planId: number;
+        data: PlanSlotBulkRequest;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationResult<Awaited<ReturnType<typeof bulkUpdateSlotsPlansPlanIdSlotsBulkPatch>>, TError, {
+    planId: number;
+    data: PlanSlotBulkRequest;
+}, TContext>;
+/**
+ * draft → active, validating every slot is filled or explicitly skip.
+ * @summary Activate Plan
+ */
+export declare const activatePlanPlansPlanIdActivatePost: (planId: number, options?: AxiosRequestConfig) => Promise<AxiosResponse<MealPlanDetailResponse>>;
+export declare const getActivatePlanPlansPlanIdActivatePostMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof activatePlanPlansPlanIdActivatePost>>, TError, {
+        planId: number;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationOptions<Awaited<ReturnType<typeof activatePlanPlansPlanIdActivatePost>>, TError, {
+    planId: number;
+}, TContext>;
+export type ActivatePlanPlansPlanIdActivatePostMutationResult = NonNullable<Awaited<ReturnType<typeof activatePlanPlansPlanIdActivatePost>>>;
+export type ActivatePlanPlansPlanIdActivatePostMutationError = AxiosError<HTTPValidationError>;
+/**
+* @summary Activate Plan
+*/
+export declare const useActivatePlanPlansPlanIdActivatePost: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof activatePlanPlansPlanIdActivatePost>>, TError, {
+        planId: number;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationResult<Awaited<ReturnType<typeof activatePlanPlansPlanIdActivatePost>>, TError, {
+    planId: number;
+}, TContext>;
+/**
+ * Derive the grocery list from plan gaps (§10): aggregated slot recipe
+ingredients scaled by servings, minus on-hand pantry quantities under the
+same-family unit rules — bulk-added with reason=missing_for_plan.
+ * @summary Derive Grocery List
+ */
+export declare const deriveGroceryListPlansPlanIdGroceryListPost: (planId: number, planGroceryListRequest: PlanGroceryListRequest, options?: AxiosRequestConfig) => Promise<AxiosResponse<PlanGroceryListResponse>>;
+export declare const getDeriveGroceryListPlansPlanIdGroceryListPostMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof deriveGroceryListPlansPlanIdGroceryListPost>>, TError, {
+        planId: number;
+        data: PlanGroceryListRequest;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationOptions<Awaited<ReturnType<typeof deriveGroceryListPlansPlanIdGroceryListPost>>, TError, {
+    planId: number;
+    data: PlanGroceryListRequest;
+}, TContext>;
+export type DeriveGroceryListPlansPlanIdGroceryListPostMutationResult = NonNullable<Awaited<ReturnType<typeof deriveGroceryListPlansPlanIdGroceryListPost>>>;
+export type DeriveGroceryListPlansPlanIdGroceryListPostMutationBody = PlanGroceryListRequest;
+export type DeriveGroceryListPlansPlanIdGroceryListPostMutationError = AxiosError<HTTPValidationError>;
+/**
+* @summary Derive Grocery List
+*/
+export declare const useDeriveGroceryListPlansPlanIdGroceryListPost: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof deriveGroceryListPlansPlanIdGroceryListPost>>, TError, {
+        planId: number;
+        data: PlanGroceryListRequest;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationResult<Awaited<ReturnType<typeof deriveGroceryListPlansPlanIdGroceryListPost>>, TError, {
+    planId: number;
+    data: PlanGroceryListRequest;
+}, TContext>;
+/**
+ * @summary List Shopping Lists
+ */
+export declare const listShoppingListsShoppingListsGet: (params?: ListShoppingListsShoppingListsGetParams, options?: AxiosRequestConfig) => Promise<AxiosResponse<ShoppingListResponse[]>>;
+export declare const getListShoppingListsShoppingListsGetQueryKey: (params?: ListShoppingListsShoppingListsGetParams) => readonly ["/shopping-lists/", ...ListShoppingListsShoppingListsGetParams[]];
+export declare const getListShoppingListsShoppingListsGetQueryOptions: <TData = Awaited<ReturnType<typeof listShoppingListsShoppingListsGet>>, TError = AxiosError<HTTPValidationError>>(params?: ListShoppingListsShoppingListsGetParams, options?: {
+    query?: UseQueryOptions<Awaited<ReturnType<typeof listShoppingListsShoppingListsGet>>, TError, TData>;
+    axios?: AxiosRequestConfig;
+}) => UseQueryOptions<Awaited<ReturnType<typeof listShoppingListsShoppingListsGet>>, TError, TData> & {
+    queryKey: QueryKey;
+};
+export type ListShoppingListsShoppingListsGetQueryResult = NonNullable<Awaited<ReturnType<typeof listShoppingListsShoppingListsGet>>>;
+export type ListShoppingListsShoppingListsGetQueryError = AxiosError<HTTPValidationError>;
+/**
+ * @summary List Shopping Lists
+ */
+export declare function useListShoppingListsShoppingListsGet<TData = Awaited<ReturnType<typeof listShoppingListsShoppingListsGet>>, TError = AxiosError<HTTPValidationError>>(params?: ListShoppingListsShoppingListsGetParams, options?: {
+    query?: UseQueryOptions<Awaited<ReturnType<typeof listShoppingListsShoppingListsGet>>, TError, TData>;
+    axios?: AxiosRequestConfig;
+}): UseQueryResult<TData, TError> & {
+    queryKey: QueryKey;
+};
+/**
+ * @summary Create Shopping List
+ */
+export declare const createShoppingListShoppingListsPost: (shoppingListCreate: ShoppingListCreate, options?: AxiosRequestConfig) => Promise<AxiosResponse<ShoppingListResponse>>;
+export declare const getCreateShoppingListShoppingListsPostMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof createShoppingListShoppingListsPost>>, TError, {
+        data: ShoppingListCreate;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationOptions<Awaited<ReturnType<typeof createShoppingListShoppingListsPost>>, TError, {
+    data: ShoppingListCreate;
+}, TContext>;
+export type CreateShoppingListShoppingListsPostMutationResult = NonNullable<Awaited<ReturnType<typeof createShoppingListShoppingListsPost>>>;
+export type CreateShoppingListShoppingListsPostMutationBody = ShoppingListCreate;
+export type CreateShoppingListShoppingListsPostMutationError = AxiosError<HTTPValidationError>;
+/**
+* @summary Create Shopping List
+*/
+export declare const useCreateShoppingListShoppingListsPost: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof createShoppingListShoppingListsPost>>, TError, {
+        data: ShoppingListCreate;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationResult<Awaited<ReturnType<typeof createShoppingListShoppingListsPost>>, TError, {
+    data: ShoppingListCreate;
+}, TContext>;
+/**
+ * @summary Get Shopping List
+ */
+export declare const getShoppingListShoppingListsListIdGet: (listId: number, options?: AxiosRequestConfig) => Promise<AxiosResponse<ShoppingListDetailResponse>>;
+export declare const getGetShoppingListShoppingListsListIdGetQueryKey: (listId?: number) => readonly ["/shopping-lists/undefined" | `/shopping-lists/${number}`];
+export declare const getGetShoppingListShoppingListsListIdGetQueryOptions: <TData = Awaited<ReturnType<typeof getShoppingListShoppingListsListIdGet>>, TError = AxiosError<HTTPValidationError>>(listId: number, options?: {
+    query?: UseQueryOptions<Awaited<ReturnType<typeof getShoppingListShoppingListsListIdGet>>, TError, TData>;
+    axios?: AxiosRequestConfig;
+}) => UseQueryOptions<Awaited<ReturnType<typeof getShoppingListShoppingListsListIdGet>>, TError, TData> & {
+    queryKey: QueryKey;
+};
+export type GetShoppingListShoppingListsListIdGetQueryResult = NonNullable<Awaited<ReturnType<typeof getShoppingListShoppingListsListIdGet>>>;
+export type GetShoppingListShoppingListsListIdGetQueryError = AxiosError<HTTPValidationError>;
+/**
+ * @summary Get Shopping List
+ */
+export declare function useGetShoppingListShoppingListsListIdGet<TData = Awaited<ReturnType<typeof getShoppingListShoppingListsListIdGet>>, TError = AxiosError<HTTPValidationError>>(listId: number, options?: {
+    query?: UseQueryOptions<Awaited<ReturnType<typeof getShoppingListShoppingListsListIdGet>>, TError, TData>;
+    axios?: AxiosRequestConfig;
+}): UseQueryResult<TData, TError> & {
+    queryKey: QueryKey;
+};
+/**
+ * Rename a list or change its status (active|archived).
+ * @summary Update Shopping List
+ */
+export declare const updateShoppingListShoppingListsListIdPut: (listId: number, shoppingListUpdate: ShoppingListUpdate, options?: AxiosRequestConfig) => Promise<AxiosResponse<ShoppingListResponse>>;
+export declare const getUpdateShoppingListShoppingListsListIdPutMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof updateShoppingListShoppingListsListIdPut>>, TError, {
+        listId: number;
+        data: ShoppingListUpdate;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationOptions<Awaited<ReturnType<typeof updateShoppingListShoppingListsListIdPut>>, TError, {
+    listId: number;
+    data: ShoppingListUpdate;
+}, TContext>;
+export type UpdateShoppingListShoppingListsListIdPutMutationResult = NonNullable<Awaited<ReturnType<typeof updateShoppingListShoppingListsListIdPut>>>;
+export type UpdateShoppingListShoppingListsListIdPutMutationBody = ShoppingListUpdate;
+export type UpdateShoppingListShoppingListsListIdPutMutationError = AxiosError<HTTPValidationError>;
+/**
+* @summary Update Shopping List
+*/
+export declare const useUpdateShoppingListShoppingListsListIdPut: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof updateShoppingListShoppingListsListIdPut>>, TError, {
+        listId: number;
+        data: ShoppingListUpdate;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationResult<Awaited<ReturnType<typeof updateShoppingListShoppingListsListIdPut>>, TError, {
+    listId: number;
+    data: ShoppingListUpdate;
+}, TContext>;
+/**
+ * @summary Delete Shopping List
+ */
+export declare const deleteShoppingListShoppingListsListIdDelete: (listId: number, options?: AxiosRequestConfig) => Promise<AxiosResponse<DeleteShoppingListShoppingListsListIdDelete200>>;
+export declare const getDeleteShoppingListShoppingListsListIdDeleteMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof deleteShoppingListShoppingListsListIdDelete>>, TError, {
+        listId: number;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationOptions<Awaited<ReturnType<typeof deleteShoppingListShoppingListsListIdDelete>>, TError, {
+    listId: number;
+}, TContext>;
+export type DeleteShoppingListShoppingListsListIdDeleteMutationResult = NonNullable<Awaited<ReturnType<typeof deleteShoppingListShoppingListsListIdDelete>>>;
+export type DeleteShoppingListShoppingListsListIdDeleteMutationError = AxiosError<HTTPValidationError>;
+/**
+* @summary Delete Shopping List
+*/
+export declare const useDeleteShoppingListShoppingListsListIdDelete: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof deleteShoppingListShoppingListsListIdDelete>>, TError, {
+        listId: number;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationResult<Awaited<ReturnType<typeof deleteShoppingListShoppingListsListIdDelete>>, TError, {
+    listId: number;
+}, TContext>;
+/**
+ * One-click order export (§10): the list's unchecked items as a grouped
+text checklist, CSV rows, or a provider deeplink.
+ * @summary Export Shopping List
+ */
+export declare const exportShoppingListShoppingListsListIdExportPost: (listId: number, shoppingListExportRequest: ShoppingListExportRequest, options?: AxiosRequestConfig) => Promise<AxiosResponse<ShoppingListExportResponse>>;
+export declare const getExportShoppingListShoppingListsListIdExportPostMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof exportShoppingListShoppingListsListIdExportPost>>, TError, {
+        listId: number;
+        data: ShoppingListExportRequest;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationOptions<Awaited<ReturnType<typeof exportShoppingListShoppingListsListIdExportPost>>, TError, {
+    listId: number;
+    data: ShoppingListExportRequest;
+}, TContext>;
+export type ExportShoppingListShoppingListsListIdExportPostMutationResult = NonNullable<Awaited<ReturnType<typeof exportShoppingListShoppingListsListIdExportPost>>>;
+export type ExportShoppingListShoppingListsListIdExportPostMutationBody = ShoppingListExportRequest;
+export type ExportShoppingListShoppingListsListIdExportPostMutationError = AxiosError<HTTPValidationError>;
+/**
+* @summary Export Shopping List
+*/
+export declare const useExportShoppingListShoppingListsListIdExportPost: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof exportShoppingListShoppingListsListIdExportPost>>, TError, {
+        listId: number;
+        data: ShoppingListExportRequest;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationResult<Awaited<ReturnType<typeof exportShoppingListShoppingListsListIdExportPost>>, TError, {
+    listId: number;
+    data: ShoppingListExportRequest;
+}, TContext>;
+/**
+ * @summary Add Shopping List Item
+ */
+export declare const addShoppingListItemShoppingListsListIdItemsPost: (listId: number, shoppingListItemCreate: ShoppingListItemCreate, options?: AxiosRequestConfig) => Promise<AxiosResponse<ShoppingListItemResponse>>;
+export declare const getAddShoppingListItemShoppingListsListIdItemsPostMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof addShoppingListItemShoppingListsListIdItemsPost>>, TError, {
+        listId: number;
+        data: ShoppingListItemCreate;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationOptions<Awaited<ReturnType<typeof addShoppingListItemShoppingListsListIdItemsPost>>, TError, {
+    listId: number;
+    data: ShoppingListItemCreate;
+}, TContext>;
+export type AddShoppingListItemShoppingListsListIdItemsPostMutationResult = NonNullable<Awaited<ReturnType<typeof addShoppingListItemShoppingListsListIdItemsPost>>>;
+export type AddShoppingListItemShoppingListsListIdItemsPostMutationBody = ShoppingListItemCreate;
+export type AddShoppingListItemShoppingListsListIdItemsPostMutationError = AxiosError<HTTPValidationError>;
+/**
+* @summary Add Shopping List Item
+*/
+export declare const useAddShoppingListItemShoppingListsListIdItemsPost: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof addShoppingListItemShoppingListsListIdItemsPost>>, TError, {
+        listId: number;
+        data: ShoppingListItemCreate;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationResult<Awaited<ReturnType<typeof addShoppingListItemShoppingListsListIdItemsPost>>, TError, {
+    listId: number;
+    data: ShoppingListItemCreate;
+}, TContext>;
+/**
+ * Bulk add items (plan gaps, preset starters) — §4.2 conventions with
+client_ref idempotency.
+ * @summary Bulk Add Shopping List Items
+ */
+export declare const bulkAddShoppingListItemsShoppingListsListIdItemsBulkPost: (listId: number, shoppingListItemBulkCreateRequest: ShoppingListItemBulkCreateRequest, options?: AxiosRequestConfig) => Promise<AxiosResponse<BulkResponse>>;
+export declare const getBulkAddShoppingListItemsShoppingListsListIdItemsBulkPostMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof bulkAddShoppingListItemsShoppingListsListIdItemsBulkPost>>, TError, {
+        listId: number;
+        data: ShoppingListItemBulkCreateRequest;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationOptions<Awaited<ReturnType<typeof bulkAddShoppingListItemsShoppingListsListIdItemsBulkPost>>, TError, {
+    listId: number;
+    data: ShoppingListItemBulkCreateRequest;
+}, TContext>;
+export type BulkAddShoppingListItemsShoppingListsListIdItemsBulkPostMutationResult = NonNullable<Awaited<ReturnType<typeof bulkAddShoppingListItemsShoppingListsListIdItemsBulkPost>>>;
+export type BulkAddShoppingListItemsShoppingListsListIdItemsBulkPostMutationBody = ShoppingListItemBulkCreateRequest;
+export type BulkAddShoppingListItemsShoppingListsListIdItemsBulkPostMutationError = AxiosError<HTTPValidationError>;
+/**
+* @summary Bulk Add Shopping List Items
+*/
+export declare const useBulkAddShoppingListItemsShoppingListsListIdItemsBulkPost: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof bulkAddShoppingListItemsShoppingListsListIdItemsBulkPost>>, TError, {
+        listId: number;
+        data: ShoppingListItemBulkCreateRequest;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationResult<Awaited<ReturnType<typeof bulkAddShoppingListItemsShoppingListsListIdItemsBulkPost>>, TError, {
+    listId: number;
+    data: ShoppingListItemBulkCreateRequest;
+}, TContext>;
+/**
+ * Bulk update/check items; ``check_all=true`` is the one-tap check-all.
+ * @summary Bulk Update Shopping List Items
+ */
+export declare const bulkUpdateShoppingListItemsShoppingListsListIdItemsBulkPatch: (listId: number, shoppingListItemBulkUpdateRequest: ShoppingListItemBulkUpdateRequest, options?: AxiosRequestConfig) => Promise<AxiosResponse<BulkResponse>>;
+export declare const getBulkUpdateShoppingListItemsShoppingListsListIdItemsBulkPatchMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof bulkUpdateShoppingListItemsShoppingListsListIdItemsBulkPatch>>, TError, {
+        listId: number;
+        data: ShoppingListItemBulkUpdateRequest;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationOptions<Awaited<ReturnType<typeof bulkUpdateShoppingListItemsShoppingListsListIdItemsBulkPatch>>, TError, {
+    listId: number;
+    data: ShoppingListItemBulkUpdateRequest;
+}, TContext>;
+export type BulkUpdateShoppingListItemsShoppingListsListIdItemsBulkPatchMutationResult = NonNullable<Awaited<ReturnType<typeof bulkUpdateShoppingListItemsShoppingListsListIdItemsBulkPatch>>>;
+export type BulkUpdateShoppingListItemsShoppingListsListIdItemsBulkPatchMutationBody = ShoppingListItemBulkUpdateRequest;
+export type BulkUpdateShoppingListItemsShoppingListsListIdItemsBulkPatchMutationError = AxiosError<HTTPValidationError>;
+/**
+* @summary Bulk Update Shopping List Items
+*/
+export declare const useBulkUpdateShoppingListItemsShoppingListsListIdItemsBulkPatch: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof bulkUpdateShoppingListItemsShoppingListsListIdItemsBulkPatch>>, TError, {
+        listId: number;
+        data: ShoppingListItemBulkUpdateRequest;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationResult<Awaited<ReturnType<typeof bulkUpdateShoppingListItemsShoppingListsListIdItemsBulkPatch>>, TError, {
+    listId: number;
+    data: ShoppingListItemBulkUpdateRequest;
+}, TContext>;
+/**
+ * @summary Bulk Delete Shopping List Items
+ */
+export declare const bulkDeleteShoppingListItemsShoppingListsListIdItemsBulkDeletePost: (listId: number, shoppingListItemBulkDeleteRequest: ShoppingListItemBulkDeleteRequest, options?: AxiosRequestConfig) => Promise<AxiosResponse<BulkResponse>>;
+export declare const getBulkDeleteShoppingListItemsShoppingListsListIdItemsBulkDeletePostMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof bulkDeleteShoppingListItemsShoppingListsListIdItemsBulkDeletePost>>, TError, {
+        listId: number;
+        data: ShoppingListItemBulkDeleteRequest;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationOptions<Awaited<ReturnType<typeof bulkDeleteShoppingListItemsShoppingListsListIdItemsBulkDeletePost>>, TError, {
+    listId: number;
+    data: ShoppingListItemBulkDeleteRequest;
+}, TContext>;
+export type BulkDeleteShoppingListItemsShoppingListsListIdItemsBulkDeletePostMutationResult = NonNullable<Awaited<ReturnType<typeof bulkDeleteShoppingListItemsShoppingListsListIdItemsBulkDeletePost>>>;
+export type BulkDeleteShoppingListItemsShoppingListsListIdItemsBulkDeletePostMutationBody = ShoppingListItemBulkDeleteRequest;
+export type BulkDeleteShoppingListItemsShoppingListsListIdItemsBulkDeletePostMutationError = AxiosError<HTTPValidationError>;
+/**
+* @summary Bulk Delete Shopping List Items
+*/
+export declare const useBulkDeleteShoppingListItemsShoppingListsListIdItemsBulkDeletePost: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof bulkDeleteShoppingListItemsShoppingListsListIdItemsBulkDeletePost>>, TError, {
+        listId: number;
+        data: ShoppingListItemBulkDeleteRequest;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationResult<Awaited<ReturnType<typeof bulkDeleteShoppingListItemsShoppingListsListIdItemsBulkDeletePost>>, TError, {
+    listId: number;
+    data: ShoppingListItemBulkDeleteRequest;
+}, TContext>;
+/**
+ * @summary Update Shopping List Item
+ */
+export declare const updateShoppingListItemShoppingListsListIdItemsItemIdPatch: (listId: number, itemId: number, shoppingListItemUpdate: ShoppingListItemUpdate, options?: AxiosRequestConfig) => Promise<AxiosResponse<ShoppingListItemResponse>>;
+export declare const getUpdateShoppingListItemShoppingListsListIdItemsItemIdPatchMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof updateShoppingListItemShoppingListsListIdItemsItemIdPatch>>, TError, {
+        listId: number;
+        itemId: number;
+        data: ShoppingListItemUpdate;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationOptions<Awaited<ReturnType<typeof updateShoppingListItemShoppingListsListIdItemsItemIdPatch>>, TError, {
+    listId: number;
+    itemId: number;
+    data: ShoppingListItemUpdate;
+}, TContext>;
+export type UpdateShoppingListItemShoppingListsListIdItemsItemIdPatchMutationResult = NonNullable<Awaited<ReturnType<typeof updateShoppingListItemShoppingListsListIdItemsItemIdPatch>>>;
+export type UpdateShoppingListItemShoppingListsListIdItemsItemIdPatchMutationBody = ShoppingListItemUpdate;
+export type UpdateShoppingListItemShoppingListsListIdItemsItemIdPatchMutationError = AxiosError<HTTPValidationError>;
+/**
+* @summary Update Shopping List Item
+*/
+export declare const useUpdateShoppingListItemShoppingListsListIdItemsItemIdPatch: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof updateShoppingListItemShoppingListsListIdItemsItemIdPatch>>, TError, {
+        listId: number;
+        itemId: number;
+        data: ShoppingListItemUpdate;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationResult<Awaited<ReturnType<typeof updateShoppingListItemShoppingListsListIdItemsItemIdPatch>>, TError, {
+    listId: number;
+    itemId: number;
+    data: ShoppingListItemUpdate;
+}, TContext>;
+/**
+ * @summary Delete Shopping List Item
+ */
+export declare const deleteShoppingListItemShoppingListsListIdItemsItemIdDelete: (listId: number, itemId: number, options?: AxiosRequestConfig) => Promise<AxiosResponse<DeleteShoppingListItemShoppingListsListIdItemsItemIdDelete200>>;
+export declare const getDeleteShoppingListItemShoppingListsListIdItemsItemIdDeleteMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof deleteShoppingListItemShoppingListsListIdItemsItemIdDelete>>, TError, {
+        listId: number;
+        itemId: number;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationOptions<Awaited<ReturnType<typeof deleteShoppingListItemShoppingListsListIdItemsItemIdDelete>>, TError, {
+    listId: number;
+    itemId: number;
+}, TContext>;
+export type DeleteShoppingListItemShoppingListsListIdItemsItemIdDeleteMutationResult = NonNullable<Awaited<ReturnType<typeof deleteShoppingListItemShoppingListsListIdItemsItemIdDelete>>>;
+export type DeleteShoppingListItemShoppingListsListIdItemsItemIdDeleteMutationError = AxiosError<HTTPValidationError>;
+/**
+* @summary Delete Shopping List Item
+*/
+export declare const useDeleteShoppingListItemShoppingListsListIdItemsItemIdDelete: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof deleteShoppingListItemShoppingListsListIdItemsItemIdDelete>>, TError, {
+        listId: number;
+        itemId: number;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationResult<Awaited<ReturnType<typeof deleteShoppingListItemShoppingListsListIdItemsItemIdDelete>>, TError, {
+    listId: number;
+    itemId: number;
+}, TContext>;
+/**
+ * Generate a recipe tailored to the user's current pantry contents.
+ * @summary Generate Recipe
+ */
+export declare const generateRecipeAiGenerateRecipePost: (generateRecipeRequest: GenerateRecipeRequest, options?: AxiosRequestConfig) => Promise<AxiosResponse<GenerateRecipeAiGenerateRecipePost200>>;
+export declare const getGenerateRecipeAiGenerateRecipePostMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof generateRecipeAiGenerateRecipePost>>, TError, {
+        data: GenerateRecipeRequest;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationOptions<Awaited<ReturnType<typeof generateRecipeAiGenerateRecipePost>>, TError, {
+    data: GenerateRecipeRequest;
+}, TContext>;
+export type GenerateRecipeAiGenerateRecipePostMutationResult = NonNullable<Awaited<ReturnType<typeof generateRecipeAiGenerateRecipePost>>>;
+export type GenerateRecipeAiGenerateRecipePostMutationBody = GenerateRecipeRequest;
+export type GenerateRecipeAiGenerateRecipePostMutationError = AxiosError<HTTPValidationError>;
+/**
+* @summary Generate Recipe
+*/
+export declare const useGenerateRecipeAiGenerateRecipePost: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof generateRecipeAiGenerateRecipePost>>, TError, {
+        data: GenerateRecipeRequest;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationResult<Awaited<ReturnType<typeof generateRecipeAiGenerateRecipePost>>, TError, {
+    data: GenerateRecipeRequest;
+}, TContext>;
+/**
+ * Stream a recipe generation response using Server-Sent Events.
+ * @summary Generate Recipe Stream
+ */
+export declare const generateRecipeStreamAiGenerateRecipeStreamPost: (generateRecipeRequest: GenerateRecipeRequest, options?: AxiosRequestConfig) => Promise<AxiosResponse<unknown>>;
+export declare const getGenerateRecipeStreamAiGenerateRecipeStreamPostMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof generateRecipeStreamAiGenerateRecipeStreamPost>>, TError, {
+        data: GenerateRecipeRequest;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationOptions<Awaited<ReturnType<typeof generateRecipeStreamAiGenerateRecipeStreamPost>>, TError, {
+    data: GenerateRecipeRequest;
+}, TContext>;
+export type GenerateRecipeStreamAiGenerateRecipeStreamPostMutationResult = NonNullable<Awaited<ReturnType<typeof generateRecipeStreamAiGenerateRecipeStreamPost>>>;
+export type GenerateRecipeStreamAiGenerateRecipeStreamPostMutationBody = GenerateRecipeRequest;
+export type GenerateRecipeStreamAiGenerateRecipeStreamPostMutationError = AxiosError<HTTPValidationError>;
+/**
+* @summary Generate Recipe Stream
+*/
+export declare const useGenerateRecipeStreamAiGenerateRecipeStreamPost: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof generateRecipeStreamAiGenerateRecipeStreamPost>>, TError, {
+        data: GenerateRecipeRequest;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationResult<Awaited<ReturnType<typeof generateRecipeStreamAiGenerateRecipeStreamPost>>, TError, {
+    data: GenerateRecipeRequest;
+}, TContext>;
+/**
+ * Grounded recipe suggestion (blueprint §9.1) — the primary path.
+
+Stage 1: deterministic coverage retrieval over catalog + household
+recipes (no LLM). Stage 2: the LLM reranks/adapts candidates by catalog
+id — choose/scale/substitute/explain only. Persist-on-save goes through
+POST /catalog/recipes/{id}/save. When the LLM is disabled,
+GET /recipes/suggestions serves the Stage-1 ranking as the degraded path.
+ * @summary Suggest Recipes
+ */
+export declare const suggestRecipesAiSuggestRecipesPost: (suggestRecipesRequest: SuggestRecipesRequest, options?: AxiosRequestConfig) => Promise<AxiosResponse<SuggestRecipesResponse>>;
+export declare const getSuggestRecipesAiSuggestRecipesPostMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof suggestRecipesAiSuggestRecipesPost>>, TError, {
+        data: SuggestRecipesRequest;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationOptions<Awaited<ReturnType<typeof suggestRecipesAiSuggestRecipesPost>>, TError, {
+    data: SuggestRecipesRequest;
+}, TContext>;
+export type SuggestRecipesAiSuggestRecipesPostMutationResult = NonNullable<Awaited<ReturnType<typeof suggestRecipesAiSuggestRecipesPost>>>;
+export type SuggestRecipesAiSuggestRecipesPostMutationBody = SuggestRecipesRequest;
+export type SuggestRecipesAiSuggestRecipesPostMutationError = AxiosError<HTTPValidationError>;
+/**
+* @summary Suggest Recipes
+*/
+export declare const useSuggestRecipesAiSuggestRecipesPost: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof suggestRecipesAiSuggestRecipesPost>>, TError, {
+        data: SuggestRecipesRequest;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationResult<Awaited<ReturnType<typeof suggestRecipesAiSuggestRecipesPost>>, TError, {
+    data: SuggestRecipesRequest;
+}, TContext>;
+/**
+ * Generate a multi-day meal plan from the user's current pantry.
+ * @summary Generate Meal Plan
+ */
+export declare const generateMealPlanAiMealPlanPost: (mealPlanRequest: MealPlanRequest, options?: AxiosRequestConfig) => Promise<AxiosResponse<GenerateMealPlanAiMealPlanPost200>>;
+export declare const getGenerateMealPlanAiMealPlanPostMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof generateMealPlanAiMealPlanPost>>, TError, {
+        data: MealPlanRequest;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationOptions<Awaited<ReturnType<typeof generateMealPlanAiMealPlanPost>>, TError, {
+    data: MealPlanRequest;
+}, TContext>;
+export type GenerateMealPlanAiMealPlanPostMutationResult = NonNullable<Awaited<ReturnType<typeof generateMealPlanAiMealPlanPost>>>;
+export type GenerateMealPlanAiMealPlanPostMutationBody = MealPlanRequest;
+export type GenerateMealPlanAiMealPlanPostMutationError = AxiosError<HTTPValidationError>;
+/**
+* @summary Generate Meal Plan
+*/
+export declare const useGenerateMealPlanAiMealPlanPost: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof generateMealPlanAiMealPlanPost>>, TError, {
+        data: MealPlanRequest;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationResult<Awaited<ReturnType<typeof generateMealPlanAiMealPlanPost>>, TError, {
+    data: MealPlanRequest;
+}, TContext>;
+/**
+ * Score the user's saved recipes against a natural language query.
+ * @summary Semantic Search
+ */
+export declare const semanticSearchAiSearchPost: (searchRequest: SearchRequest, options?: AxiosRequestConfig) => Promise<AxiosResponse<SemanticSearchAiSearchPost200>>;
+export declare const getSemanticSearchAiSearchPostMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof semanticSearchAiSearchPost>>, TError, {
+        data: SearchRequest;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationOptions<Awaited<ReturnType<typeof semanticSearchAiSearchPost>>, TError, {
+    data: SearchRequest;
+}, TContext>;
+export type SemanticSearchAiSearchPostMutationResult = NonNullable<Awaited<ReturnType<typeof semanticSearchAiSearchPost>>>;
+export type SemanticSearchAiSearchPostMutationBody = SearchRequest;
+export type SemanticSearchAiSearchPostMutationError = AxiosError<HTTPValidationError>;
+/**
+* @summary Semantic Search
+*/
+export declare const useSemanticSearchAiSearchPost: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof semanticSearchAiSearchPost>>, TError, {
+        data: SearchRequest;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationResult<Awaited<ReturnType<typeof semanticSearchAiSearchPost>>, TError, {
+    data: SearchRequest;
+}, TContext>;
+/**
+ * Recognize pantry items from a photo via the configured vision backend.
+
+The image is validated (MIME whitelist + size cap, same rules as pantry
+uploads) and sent to the vision provider in memory — it is not persisted;
+the client can attach it again when saving items via POST /pantry-items/.
+Recognized items are normalized to the app's enums before returning.
+ * @summary Recognize Items
+ */
+export declare const recognizeItemsAiRecognizeItemsPost: (bodyRecognizeItemsAiRecognizeItemsPost: BodyRecognizeItemsAiRecognizeItemsPost, options?: AxiosRequestConfig) => Promise<AxiosResponse<RecognizeItemsAiRecognizeItemsPost200>>;
+export declare const getRecognizeItemsAiRecognizeItemsPostMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof recognizeItemsAiRecognizeItemsPost>>, TError, {
+        data: BodyRecognizeItemsAiRecognizeItemsPost;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationOptions<Awaited<ReturnType<typeof recognizeItemsAiRecognizeItemsPost>>, TError, {
+    data: BodyRecognizeItemsAiRecognizeItemsPost;
+}, TContext>;
+export type RecognizeItemsAiRecognizeItemsPostMutationResult = NonNullable<Awaited<ReturnType<typeof recognizeItemsAiRecognizeItemsPost>>>;
+export type RecognizeItemsAiRecognizeItemsPostMutationBody = BodyRecognizeItemsAiRecognizeItemsPost;
+export type RecognizeItemsAiRecognizeItemsPostMutationError = AxiosError<HTTPValidationError>;
+/**
+* @summary Recognize Items
+*/
+export declare const useRecognizeItemsAiRecognizeItemsPost: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof recognizeItemsAiRecognizeItemsPost>>, TError, {
+        data: BodyRecognizeItemsAiRecognizeItemsPost;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationResult<Awaited<ReturnType<typeof recognizeItemsAiRecognizeItemsPost>>, TError, {
+    data: BodyRecognizeItemsAiRecognizeItemsPost;
+}, TContext>;
+/**
+ * Read a grocery receipt photo into confirm-ready pantry drafts (§11).
+
+The vision backend extracts one ReceiptLine per purchased item (taxes,
+totals and non-food skipped by the prompt); the server then normalizes
+units (same coercion as photo/barcode recognition), links each line to
+the catalog via the ingredient linker (misses stay null with raw_name
+preserved), and attaches restock prefill hints: suggested_location_id
+from purchase history and suggested_expiration_date from catalog shelf
+life — the latter always flagged low-confidence. The confirm screen posts
+edited lines to POST /pantry-items/bulk with source=receipt.
+ * @summary Recognize Receipt
+ */
+export declare const recognizeReceiptAiRecognizeReceiptPost: (bodyRecognizeReceiptAiRecognizeReceiptPost: BodyRecognizeReceiptAiRecognizeReceiptPost, options?: AxiosRequestConfig) => Promise<AxiosResponse<RecognizeReceiptAiRecognizeReceiptPost200>>;
+export declare const getRecognizeReceiptAiRecognizeReceiptPostMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof recognizeReceiptAiRecognizeReceiptPost>>, TError, {
+        data: BodyRecognizeReceiptAiRecognizeReceiptPost;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationOptions<Awaited<ReturnType<typeof recognizeReceiptAiRecognizeReceiptPost>>, TError, {
+    data: BodyRecognizeReceiptAiRecognizeReceiptPost;
+}, TContext>;
+export type RecognizeReceiptAiRecognizeReceiptPostMutationResult = NonNullable<Awaited<ReturnType<typeof recognizeReceiptAiRecognizeReceiptPost>>>;
+export type RecognizeReceiptAiRecognizeReceiptPostMutationBody = BodyRecognizeReceiptAiRecognizeReceiptPost;
+export type RecognizeReceiptAiRecognizeReceiptPostMutationError = AxiosError<HTTPValidationError>;
+/**
+* @summary Recognize Receipt
+*/
+export declare const useRecognizeReceiptAiRecognizeReceiptPost: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof recognizeReceiptAiRecognizeReceiptPost>>, TError, {
+        data: BodyRecognizeReceiptAiRecognizeReceiptPost;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationResult<Awaited<ReturnType<typeof recognizeReceiptAiRecognizeReceiptPost>>, TError, {
+    data: BodyRecognizeReceiptAiRecognizeReceiptPost;
+}, TContext>;
+/**
+ * Look up a UPC/EAN barcode on Open Food Facts and return a normalized item draft.
+
+Deterministic and free; no LLM involved.  item_type is inferred from OFF's
+crowd-sourced categories and is always flagged low-confidence for the user
+to confirm.
+ * @summary Lookup Barcode
+ */
+export declare const lookupBarcodeAiLookupBarcodePost: (barcodeRequest: BarcodeRequest, options?: AxiosRequestConfig) => Promise<AxiosResponse<LookupBarcodeAiLookupBarcodePost200>>;
+export declare const getLookupBarcodeAiLookupBarcodePostMutationOptions: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof lookupBarcodeAiLookupBarcodePost>>, TError, {
+        data: BarcodeRequest;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationOptions<Awaited<ReturnType<typeof lookupBarcodeAiLookupBarcodePost>>, TError, {
+    data: BarcodeRequest;
+}, TContext>;
+export type LookupBarcodeAiLookupBarcodePostMutationResult = NonNullable<Awaited<ReturnType<typeof lookupBarcodeAiLookupBarcodePost>>>;
+export type LookupBarcodeAiLookupBarcodePostMutationBody = BarcodeRequest;
+export type LookupBarcodeAiLookupBarcodePostMutationError = AxiosError<HTTPValidationError>;
+/**
+* @summary Lookup Barcode
+*/
+export declare const useLookupBarcodeAiLookupBarcodePost: <TError = AxiosError<HTTPValidationError>, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<Awaited<ReturnType<typeof lookupBarcodeAiLookupBarcodePost>>, TError, {
+        data: BarcodeRequest;
+    }, TContext>;
+    axios?: AxiosRequestConfig;
+}) => UseMutationResult<Awaited<ReturnType<typeof lookupBarcodeAiLookupBarcodePost>>, TError, {
+    data: BarcodeRequest;
+}, TContext>;
 /**
  * @summary Read Root
  */