@la-main-verte/shared-types 1.0.81 → 1.0.83

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@la-main-verte/shared-types",
-  "version": "1.0.81",
+  "version": "1.0.83",
   "description": "Shared TypeScript interfaces for frontend of la-main-verte app",
   "main": "src/index.js",
   "types": "src/index.d.ts",

package/src/home.api.d.ts

@@ -1,258 +1,276 @@
-import type { PlantI } from './plant'
-import type { SelectionI } from './selection'
-import type { TaskI } from './task'
-
-export namespace HOME {
-  export type HeroCardMode = 'featuredSelection' | 'featuredPlant'
-
-  export type SectionComponentType =
-    | 'Header'
-    | 'HeroCards'
-    | 'PlantCarousel'
-    | 'HeroCardsCarousel'
-    | 'WideCardsCarousel'
-    | 'Weather'
-    | 'AdviceCarousel'
-    | 'OnboardingCard'
-    | 'UpcomingTasks'
-
-  export type CarouselComponentType = Extract<
-    SectionComponentType,
-    'PlantCarousel' | 'HeroCardsCarousel' | 'WideCardsCarousel'
-  >
-
-  export interface WeatherDayI {
-    date: string
-    minTempC: number
-    maxTempC: number
-    iconUrl: string | null
-    condition?: string | null
-  }
-
-  export interface WeatherSectionI {
-    componentType: 'Weather'
-    title: string
-    subtitle?: string
-    locationName: string
-    timezone: string
-    days: WeatherDayI[]
-    lastUpdatedAt: string
-    dataSource: 'weatherapi'
-    backgroundColor?: string
-  }
-
-  export interface HeaderSectionI {
-    componentType: 'Header'
-    title: string
-    subtitle: string
-  }
-
-  export interface AdviceI {
-    id?: string | number
-    title: string
-    markdownContent: string
-    titleColor?: string
-    backgroundColor?: string
-  }
-
-  export interface AdviceSectionI {
-    componentType: 'AdviceCarousel'
-    title?: string
-    subtitle?: string
-    advices: AdviceI[]
-  }
-
-  export interface WideCardAuthorI {
-    name?: string | null
-    imageURL?: string | null
-  }
-
-  export interface WideCardItemI {
-    id?: string | number
-    title?: string | null
-    text: string
-    badgeText?: string | null
-    thumbnailImageURL: string
-    author?: WideCardAuthorI | null
-    link?: string | null
-    metadata?: Record<string, unknown>
-  }
-
-  export interface WideCardsCarouselSectionI {
-    componentType: 'WideCardsCarousel'
-    title: string
-    subtitle?: string
-    cards: WideCardItemI[]
-  }
-
-  export interface HeroCardBlueprintI {
-    mode: HeroCardMode
-    title?: string | null
-    description?: string | null
-    backgroundColor?: string | null
-    backgroundImageUrl?: string | null
-    ctaLabel?: string | null
-    ctaRoute?: string | null
-    previewPlants?: PlantI[]
-    selection?: SelectionI | null
-    plant?: PlantI | null
-  }
-
-  export interface HeroCardsSectionI {
-    componentType: 'HeroCards'
-    title?: string | null
-    subtitle?: string | null
-    cards: HeroCardBlueprintI[]
-  }
-
-  export interface PlantCarouselSectionI {
-    componentType: 'PlantCarousel'
-    title: string
-    subtitle?: string
-    selection: SelectionI
-    displayRanking?: boolean
-  }
-
-  export interface HeroCardsCarouselSectionI {
-    componentType: 'HeroCardsCarousel'
-    selections: SelectionI[]
-  }
-
-  export interface FamilyRecommendationI {
-    family: string
-    headline: string
-    plants: PlantI[]
-  }
-
-  export interface FamilyExplorerSectionI {
-    componentType: 'FamilyExplorer'
-    title: string
-    subtitle?: string
-    families: FamilyRecommendationI[]
-  }
-
-  export interface OnboardingStepI {
-    id: string
-    title: string
-    description: string
-    isCompleted: boolean
-    ctaLink: string
-  }
-
-  export interface OnboardingCardSectionI {
-    componentType: 'OnboardingCard'
-    title: string
-    subtitle: string
-    steps: OnboardingStepI[]
-    completedStepsCount: number
-    totalStepsCount: number
-  }
-
-  /** Minimal plant info for preview display (e.g. parent plant in grouped tasks) */
-  export interface TaskPlantPreviewI {
-    name: string
-    slug: string
-    imageURL?: string | null
-  }
-
-  /** Plant info within a family group — includes the task ID specific to this plant */
-  export interface TaskFamilyPlantPreviewI extends TaskPlantPreviewI {
-    taskId: number
-  }
-
-  /** Family group info when multiple plants share the same task */
-  export interface TaskFamilyGroupI {
-    familyName: string
-    plantsCount: number
-    plants: TaskFamilyPlantPreviewI[]
-  }
-
-  export interface UpcomingTaskI {
-    task: TaskI
-    plantName: string
-    plantSlug: string
-    plantImageURL?: string | null
-    gardenName: string
-    gardenCategory: string
-    selectionSlug: string
-    /** If this task is grouped by family */
-    familyGroup?: TaskFamilyGroupI
-  }
-
-  export interface UpcomingTaskAdviceI {
-    /** @deprecated Since 1.9.10, this field is always `''`. */
-    content: string
-    taskName: string
-    plantName: string
-    plantSlug: string
-    plantImageURL?: string | null
-    gardenName: string
-    gardenCategory: string
-    selectionSlug: string
-    task: TaskI
-    /** If this task is grouped by family */
-    familyGroup?: TaskFamilyGroupI
-  }
-
-  export interface UpcomingTasksSectionI {
-    componentType: 'UpcomingTasks'
-    title: string
-    subtitle?: string
-    advices: UpcomingTaskAdviceI[]
-  }
-
-  /** Preview plant for WhenToSeedWhat section */
-  export interface WhenToSeedWhatPlantPreviewI {
-    id: number
-    name: string
-    family?: string | null
-    slug: string
-    imageURL?: string | null
-  }
-
-  /** A generic link card section with title, subtitle, URL, and optional preview images */
-  export interface LinkCardSectionI {
-    componentType: 'LinkCard'
-    title: string
-    subtitle?: string
-    url: string
-    previewPlants?: WhenToSeedWhatPlantPreviewI[]
-    backgroundColor?: string
-    /** Show a red badge indicator (replaces the plant preview stack when true) */
-    showBadge?: boolean
-    /** Optional badge count to display */
-    badgeCount?: number
-  }
-
-  export type SectionI =
-    | HeaderSectionI
-    | HeroCardsSectionI
-    | PlantCarouselSectionI
-    | HeroCardsCarouselSectionI
-    | WideCardsCarouselSectionI
-    | WeatherSectionI
-    | AdviceSectionI
-    | OnboardingCardSectionI
-    | UpcomingTasksSectionI
-    | LinkCardSectionI
-
-  export interface Response {
-    sections: SectionI[]
-    weather?: WeatherSectionI
-    advice?: AdviceSectionI
-  }
-
-  export interface HeroCardItemI {
-    id?: string | null
-    mode: HeroCardMode
-    title?: string | null
-    description?: string | null
-    backgroundColor?: string | null
-    backgroundImageUrl?: string | null
-    previewPlants?: PlantI[]
-    ctaLabel?: string | null
-    selection?: SelectionI | null
-    plant?: PlantI | null
-    ctaRoute?: string | null
-  }
-}
+import type { PlantI } from './plant'
+import type { SelectionI } from './selection'
+import type { TaskI } from './task'
+
+export namespace HOME {
+  export type HeroCardMode = 'featuredSelection' | 'featuredPlant'
+
+  export type SectionComponentType =
+    | 'Header'
+    | 'HeroCards'
+    | 'PlantCarousel'
+    | 'HeroCardsCarousel'
+    | 'WideCardsCarousel'
+    | 'Weather'
+    | 'AdviceCarousel'
+    | 'OnboardingCard'
+    | 'UpcomingTasks'
+
+  export type CarouselComponentType = Extract<
+    SectionComponentType,
+    'PlantCarousel' | 'HeroCardsCarousel' | 'WideCardsCarousel'
+  >
+
+  export interface WeatherDayI {
+    date: string
+    minTempC: number
+    maxTempC: number
+    iconUrl: string | null
+    condition?: string | null
+  }
+
+  export interface WeatherSectionI {
+    componentType: 'Weather'
+    title: string
+    subtitle?: string
+    locationName: string
+    timezone: string
+    days: WeatherDayI[]
+    lastUpdatedAt: string
+    dataSource: 'weatherapi'
+    backgroundColor?: string
+  }
+
+  export interface HeaderSectionI {
+    componentType: 'Header'
+    title: string
+    subtitle: string
+  }
+
+  export interface AdviceI {
+    id?: string | number
+    title: string
+    markdownContent: string
+    titleColor?: string
+    backgroundColor?: string
+  }
+
+  export interface AdviceSectionI {
+    componentType: 'AdviceCarousel'
+    title?: string
+    subtitle?: string
+    advices: AdviceI[]
+  }
+
+  export interface WideCardAuthorI {
+    name?: string | null
+    imageURL?: string | null
+  }
+
+  export interface WideCardItemI {
+    id?: string | number
+    title?: string | null
+    text: string
+    badgeText?: string | null
+    thumbnailImageURL: string
+    author?: WideCardAuthorI | null
+    link?: string | null
+    metadata?: Record<string, unknown>
+  }
+
+  export interface WideCardsCarouselSectionI {
+    componentType: 'WideCardsCarousel'
+    title: string
+    subtitle?: string
+    cards: WideCardItemI[]
+  }
+
+  export interface HeroCardBlueprintI {
+    mode: HeroCardMode
+    title?: string | null
+    description?: string | null
+    backgroundColor?: string | null
+    backgroundImageUrl?: string | null
+    ctaLabel?: string | null
+    ctaRoute?: string | null
+    previewPlants?: PlantI[]
+    selection?: SelectionI | null
+    plant?: PlantI | null
+  }
+
+  export interface HeroCardsSectionI {
+    componentType: 'HeroCards'
+    title?: string | null
+    subtitle?: string | null
+    cards: HeroCardBlueprintI[]
+  }
+
+  export interface PlantCarouselSectionI {
+    componentType: 'PlantCarousel'
+    title: string
+    subtitle?: string
+    selection: SelectionI
+    displayRanking?: boolean
+  }
+
+  export interface HeroCardsCarouselSectionI {
+    componentType: 'HeroCardsCarousel'
+    selections: SelectionI[]
+  }
+
+  export interface FamilyRecommendationI {
+    family: string
+    headline: string
+    plants: PlantI[]
+  }
+
+  export interface FamilyExplorerSectionI {
+    componentType: 'FamilyExplorer'
+    title: string
+    subtitle?: string
+    families: FamilyRecommendationI[]
+  }
+
+  export interface OnboardingStepI {
+    id: string
+    title: string
+    description: string
+    isCompleted: boolean
+    ctaLink: string
+  }
+
+  export interface OnboardingCardSectionI {
+    componentType: 'OnboardingCard'
+    title: string
+    subtitle: string
+    steps: OnboardingStepI[]
+    completedStepsCount: number
+    totalStepsCount: number
+  }
+
+  /** Minimal plant info for preview display (e.g. parent plant in grouped tasks) */
+  export interface TaskPlantPreviewI {
+    name: string
+    slug: string
+    imageURL?: string | null
+  }
+
+  /** Plant info within a family group — includes the task ID specific to this plant */
+  export interface TaskFamilyPlantPreviewI extends TaskPlantPreviewI {
+    taskId: number
+  }
+
+  /** Family group info when multiple plants share the same task */
+  export interface TaskFamilyGroupI {
+    familyName: string
+    plantsCount: number
+    plants: TaskFamilyPlantPreviewI[]
+  }
+
+  export interface UpcomingTaskI {
+    task: TaskI
+    /** PlantSelection id used by task list views to group tasks per planted item. */
+    plantSelectionId?: number
+    plantName: string
+    plantSlug: string
+    plantImageURL?: string | null
+    gardenName: string
+    gardenCategory: string
+    selectionSlug: string
+    /** If this task is grouped by family */
+    familyGroup?: TaskFamilyGroupI
+  }
+
+  export type TaskListView = 'current' | 'completed' | 'earlier'
+
+  export interface TaskListTabI {
+    key: TaskListView
+    label: string
+  }
+
+  export interface TaskListResponseI {
+    view: TaskListView
+    title: string
+    subtitle: string
+    emptyListMessage: string
+    tabs: TaskListTabI[]
+    tasks: UpcomingTaskI[]
+  }
+
+  export interface UpcomingTaskAdviceI {
+    /** @deprecated Since 1.9.10, this field is always `''`. */
+    content: string
+    taskName: string
+    plantName: string
+    plantSlug: string
+    plantImageURL?: string | null
+    gardenName: string
+    gardenCategory: string
+    selectionSlug: string
+    task: TaskI
+    /** If this task is grouped by family */
+    familyGroup?: TaskFamilyGroupI
+  }
+
+  export interface UpcomingTasksSectionI {
+    componentType: 'UpcomingTasks'
+    title: string
+    subtitle?: string
+    advices: UpcomingTaskAdviceI[]
+  }
+
+  /** Preview plant for WhenToSeedWhat section */
+  export interface WhenToSeedWhatPlantPreviewI {
+    id: number
+    name: string
+    family?: string | null
+    slug: string
+    imageURL?: string | null
+  }
+
+  /** A generic link card section with title, subtitle, URL, and optional preview images */
+  export interface LinkCardSectionI {
+    componentType: 'LinkCard'
+    title: string
+    subtitle?: string
+    url: string
+    previewPlants?: WhenToSeedWhatPlantPreviewI[]
+    backgroundColor?: string
+    /** Show a red badge indicator (replaces the plant preview stack when true) */
+    showBadge?: boolean
+    /** Optional badge count to display */
+    badgeCount?: number
+  }
+
+  export type SectionI =
+    | HeaderSectionI
+    | HeroCardsSectionI
+    | PlantCarouselSectionI
+    | HeroCardsCarouselSectionI
+    | WideCardsCarouselSectionI
+    | WeatherSectionI
+    | AdviceSectionI
+    | OnboardingCardSectionI
+    | UpcomingTasksSectionI
+    | LinkCardSectionI
+
+  export interface Response {
+    sections: SectionI[]
+    weather?: WeatherSectionI
+    advice?: AdviceSectionI
+  }
+
+  export interface HeroCardItemI {
+    id?: string | null
+    mode: HeroCardMode
+    title?: string | null
+    description?: string | null
+    backgroundColor?: string | null
+    backgroundImageUrl?: string | null
+    previewPlants?: PlantI[]
+    ctaLabel?: string | null
+    selection?: SelectionI | null
+    plant?: PlantI | null
+    ctaRoute?: string | null
+  }
+}

package/src/index.ts

@@ -14,6 +14,8 @@ export * from './taggedItem'
 export * from './fertilizer'
 export * from './utmParams'
 export * from './plantFilters'
+export * from './taxonFamily'
+export * from './rotationGroup'
 import * as PlantsAPI from './plants.api'
 import * as UsersAPI from './users.api'
 import * as SessionsAPI from './sessions.api'

package/src/plant.d.ts

@@ -1,168 +1,189 @@
-import type { TaxonFamilyI } from './taxonFamily'
-import type { SeedingInfoI } from './pages.api'
-import type { PlantFilterI } from './plantFilters'
-/**
- * Range filter value for min/max filters
- */
-export interface RangeFilterValueI {
-  min: number
-  max: number
-}
-
-/**
- * Plant filter value types
- * Represents the possible values for a single filter
- */
-export type PlantFilterValueI = string | string[] | number | boolean | RangeFilterValueI
-
-/**
- * Plant attributes for filtering
- * Used in JSONB field and as query parameters
- * Supports multiple value types for different filter types
- */
-export type PlantAttributesI = Record<string, PlantFilterValueI>
-
-export interface PlantI {
-  id: number
-  name: string
-  slug: string
-  description: string
-  descriptionSource?: string
-  female: boolean
-  family?: string | null
-  taxonFamilyId?: number | null
-  spaceBetweenSeedMin: number
-  spaceBetweenSeedMax: number
-  spaceBetweenAlleyMin: number
-  spaceBetweenAlleyMax: number
-  weeksInTransplant: number
-  weeksDuringWhichYouCanSeedOutdoor: number
-  weeksToMaturity: number
-  daysToMaturity: number | null
-  weeksToWaitAfterFreezingDate: number
-  weeksToHarvest: number
-  indoorSeeding: boolean
-  outdoorSeeding: boolean
-  azoteNeedsKgPerHa: number
-  hibernate: boolean
-  germinationTemperature: number | null
-  minGerminationTemperature: number | null
-  germinationNumberOfDays: string | null
-  germinationSeedDepth: string | null
-  cultivationInfo: string | null
-  parentId: number | null
-  memberId?: number
-  memberFirstName?: string | null
-  shared: boolean
-  hexColor: string | null
-  sunRequirements: 'partialShade' | 'fullSun' | 'fullShade' | null
-  isHardy: boolean | null
-  quantityForFiveInJardinVivrier?: number | null
-  imageURL: string
-  /**
-   * Filename of the plant's 3D mesh asset stored on S3.
-   * - Ideally a `.webp` file (e.g. `ail.webp`).
-   * - Stored in S3 under the `images/meshes/` folder.
-   * - By default named after the `Plant.slug` (e.g. `ail.webp` for the garlic plant).
-   * - Only the filename is persisted; the public URL is exposed through the
-   *   virtual `meshURL` field.
-   */
-  meshFilename: string | null
-  /**
-   * Public ImageKit URL to the plant's 3D mesh asset.
-   * Virtual field computed from `meshFilename`. The underlying file is
-   * stored on S3 at `images/meshes/{meshFilename}` and rewritten to
-   * ImageKit for CDN delivery and transformations.
-   *
-   * Falls back to `imageURL` when `meshFilename` is not set.
-   *
-   * Example: `https://ik.imagekit.io/lamainverte/meshes/ail.webp`
-   */
-  meshURL: string
-  totalWeeksToMaturity: number
-  hasNoInformation: boolean
-  createdAt: Date
-  updatedAt: Date
-  translatedSunRequirements: 'Plein soleil' | 'Mi-ombre' | 'Ombre' | null
-  parent?: PlantI
-  children?: PlantI[]
-  PlantInventories?: PlantInventoryI[]
-  taggedItems?: TaggedItemI[]
-  /**
-   * List of selections that the plant is in.
-   * --------------------------------------
-   * Tends to be used for featured selections
-   */
-  Selections?: SelectionI[]
-  tasks?: TaskI[]
-  Images?: ImageI[]
-  Member?: Partial<MemberI>
-  notes?: NoteI[]
-  rotationGroup?: string
-  // @deprecate once v1.8.1 is fully adopted
-  rotationFamily?: string
-  taxonFamily?: TaxonFamilyI
-  seedingInfo: SeedingInfoI
-  /**
-   * Contextual search text for recommended plants
-   * Provides additional context when suggesting plants for specific garden zones
-   */
-  contextualSearchText?: string
-}
-
-interface PlantInventoryI {
-  id: number
-  plantId: number
-  supplierName: string
-  plantName: string
-  supplierURL: string
-  imageLocation: string
-  description: string
-  inStock: boolean
-}
-
-export type AvailableGrowingConditionsI = Record<string, string[]>
-
-/**
- * For each attribute filter key (e.g. "fruit.color"), the list of values that
- * still yield at least one match under the current search + active filters.
- * Consumed by the frontend to mark filter tags as "unavailable".
- */
-export type AvailableAttributesI = Record<string, string[]>
-
-/**
- * Which filter surface the frontend should render for the current search.
- * - `specific`: family-specific filters (e.g. tomate attributes)
- * - `general`:  global growing-conditions filters
- *
- * Mutually exclusive by design — the two sets never appear together.
- */
-export type PlantFiltersModeI = 'specific' | 'general'
-
-/**
- * Backend-driven description of the filter UI for a given search response.
- * The frontend is a dumb renderer: it shows the filters listed here with the
- * given mode and marks tags whose value is not in `availability` as unavailable.
- */
-export interface PlantFiltersUII {
-  mode: PlantFiltersModeI
-  filters: PlantFilterI[]
-  availability: Record<string, string[]>
-}
-
-export interface GrowingConditionsConfigI {
-  filters: PlantFilterI[]
-}
-
-export interface GrowingConditionsFiltersI {
-  sunRequirements?: 'partialShade' | 'fullShade'
-  rotationGroup?: 'regenerative' | 'demanding' | 'moderately_demanding' | 'less_demanding'
-}
-
-export interface PlantSearchResultI {
-  plants: PlantModelI[]
-  selections: SelectionModelI[]
-  total?: number
-  familyName?: string
-  filtersUI?: PlantFiltersUII
-}
+import type { TaxonFamilyI } from './taxonFamily'
+import type { SeedingInfoI } from './pages.api'
+import type { PlantFilterI } from './plantFilters'
+import type { RotationGroup } from './rotationGroup'
+/**
+ * Range filter value for min/max filters
+ */
+export interface RangeFilterValueI {
+  min: number
+  max: number
+}
+
+/**
+ * Plant filter value types
+ * Represents the possible values for a single filter
+ */
+export type PlantFilterValueI = string | string[] | number | boolean | RangeFilterValueI
+
+/**
+ * Plant attributes for filtering
+ * Used in JSONB field and as query parameters
+ * Supports multiple value types for different filter types
+ */
+export type PlantAttributesI = Record<string, PlantFilterValueI>
+
+export interface PlantI {
+  id: number
+  name: string
+  slug: string
+  description: string
+  descriptionSource?: string
+  female: boolean
+  family?: string | null
+  taxonFamilyId?: number | null
+  spaceBetweenSeedMin: number
+  spaceBetweenSeedMax: number
+  spaceBetweenAlleyMin: number
+  spaceBetweenAlleyMax: number
+  weeksInTransplant: number
+  weeksDuringWhichYouCanSeedOutdoor: number
+  weeksToMaturity: number
+  daysToMaturity: number | null
+  weeksToWaitAfterFreezingDate: number
+  weeksToHarvest: number
+  indoorSeeding: boolean
+  outdoorSeeding: boolean
+  azoteNeedsKgPerHa: number
+  hibernate: boolean
+  germinationTemperature: number | null
+  minGerminationTemperature: number | null
+  germinationNumberOfDays: string | null
+  germinationSeedDepth: string | null
+  cultivationInfo: string | null
+  parentId: number | null
+  memberId?: number
+  memberFirstName?: string | null
+  shared: boolean
+  hexColor: string | null
+  sunRequirements: 'partialShade' | 'fullSun' | 'fullShade' | null
+  isHardy: boolean | null
+  quantityForFiveInJardinVivrier?: number | null
+  imageURL: string
+  /**
+   * Filename of the plant's 3D mesh asset stored on S3.
+   * - Ideally a `.webp` file (e.g. `ail.webp`).
+   * - Stored in S3 under the `images/meshes/` folder.
+   * - By default named after the `Plant.slug` (e.g. `ail.webp` for the garlic plant).
+   * - Only the filename is persisted; the public URL is exposed through the
+   *   virtual `meshURL` field.
+   */
+  meshFilename: string | null
+  /**
+   * Public ImageKit URL to the plant's 3D mesh asset.
+   * Virtual field computed from `meshFilename`. The underlying file is
+   * stored on S3 at `images/meshes/{meshFilename}` and rewritten to
+   * ImageKit for CDN delivery and transformations.
+   *
+   * Falls back to `imageURL` when `meshFilename` is not set.
+   *
+   * Example: `https://ik.imagekit.io/lamainverte/meshes/ail.webp`
+   */
+  meshURL: string
+  totalWeeksToMaturity: number
+  hasNoInformation: boolean
+  createdAt: Date
+  updatedAt: Date
+  translatedSunRequirements: 'Plein soleil' | 'Mi-ombre' | 'Ombre' | null
+  parent?: PlantI
+  children?: PlantI[]
+  PlantInventories?: PlantInventoryI[]
+  taggedItems?: TaggedItemI[]
+  /**
+   * List of selections that the plant is in.
+   * --------------------------------------
+   * Tends to be used for featured selections
+   */
+  Selections?: SelectionI[]
+  tasks?: TaskI[]
+  Images?: ImageI[]
+  Member?: Partial<MemberI>
+  notes?: NoteI[]
+  /**
+   * Nitrogen-derived rotation group enum (virtual field on the Plant model).
+   * Source of truth for rotation classification — derived from
+   * `azoteNeedsKgPerHa` plus the regenerative override on `taxonFamily`.
+   */
+  rotationGroup?: RotationGroup | null
+  /**
+   * French label of `rotationGroup`, ready for display.
+   */
+  translatedRotationGroup?: string | null
+  taxonFamily?: TaxonFamilyI
+  seedingInfo: SeedingInfoI
+  /**
+   * Contextual search text for recommended plants
+   * Provides additional context when suggesting plants for specific garden zones
+   */
+  contextualSearchText?: string
+}
+
+interface PlantInventoryI {
+  id: number
+  plantId: number
+  supplierName: string
+  plantName: string
+  supplierURL: string
+  imageLocation: string
+  description: string
+  inStock: boolean
+}
+
+export type AvailableGrowingConditionsI = Record<string, string[]>
+
+/**
+ * For each attribute filter key (e.g. "fruit.color"), the list of values that
+ * still yield at least one match under the current search + active filters.
+ * Consumed by the frontend to mark filter tags as "unavailable".
+ */
+export type AvailableAttributesI = Record<string, string[]>
+
+/**
+ * Which filter surface the frontend should render for the current search.
+ * - `specific`: family-specific filters (e.g. tomate attributes)
+ * - `general`:  global growing-conditions filters
+ *
+ * Mutually exclusive by design — the two sets never appear together.
+ */
+export type PlantFiltersModeI = 'specific' | 'general'
+
+/**
+ * Backend-driven description of the filter UI for a given search response.
+ * The frontend is a dumb renderer: it shows the filters listed here with the
+ * given mode and marks tags whose value is not in `availability` as unavailable.
+ */
+export interface PlantFiltersUII {
+  mode: PlantFiltersModeI
+  filters: PlantFilterI[]
+  availability: Record<string, string[]>
+}
+
+export interface GrowingConditionsConfigI {
+  filters: PlantFilterI[]
+}
+
+export interface GrowingConditionsFiltersI {
+  sunRequirements?: 'partialShade' | 'fullShade'
+  rotationGroup?: 'regenerative' | 'demanding' | 'moderately_demanding' | 'less_demanding'
+}
+
+export interface PlantSearchResultI {
+  plants: PlantModelI[]
+  selections: SelectionModelI[]
+  total?: number
+  familyName?: string
+  filtersUI?: PlantFiltersUII
+}
+
+/**
+ * Response shape for `GET /selections/:slug/gardenZones/:id/rotation-suggestions`.
+ * - `advice`: short user-facing sentence explaining the recommendation
+ * - `Plants`: parent plants matching the recommended rotation group, with
+ *   the avoided taxon families excluded. Empty when the zone has no usable
+ *   history yet.
+ */
+export interface PlantRotationSuggestionsI {
+  targetYear: number
+  advice: string
+  Plants: PlantI[]
+}

package/src/plantSelection.d.ts

@@ -5,7 +5,6 @@ export interface PlantSelectionI {
   id: number
   plantId: number
   selectionId: number
-  seedQuantity: number
   createdAt: Date
   updatedAt: Date
   Plant: PlantI

package/src/taxonFamily.d.ts

@@ -0,0 +1,15 @@
+import type { RotationGroup } from './rotationGroup'
+
+export interface TaxonFamilyI {
+  id: number
+  slug: string
+  translation_key: string
+  name: string
+  latin_name: string | null
+  kingdom: string
+  description: string | null
+  rotation_group: RotationGroup | null
+  translated_rotation_group: string | null
+  createdAt?: Date
+  updatedAt?: Date
+}