@la-main-verte/shared-types 1.0.80 → 1.0.82

package/package.json

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

package/src/fertilizer.d.ts

@@ -1,55 +1,55 @@
-export interface FertilizerI {
-  id: number
-  name: string
-  slug: string
-  azotePercentage: number
-  phosphorePercentage: number
-  potassiumPercentage: number
-  /**
-   * The real azote percentage is the azote percentage multiplied by the azote efficiency.
-   */
-  realAzotePercentage: number
-  /**
-   * Nitrogen mineralization rate, between 0 and 1 (e.g. 0.9 for 90%).
-   */
-  nitrogenMineralizationRate: number | null
-  imageLocation: string
-  imageURL: string
-  quantitySuggested: string
-  /**
-   * Blend composition when this fertilizer is a combination of two products.
-   * Null for single fertilizers.
-   * When populated, contains the IDs and ratios (as percentages) of the primary and secondary fertilizers.
-   * The NPK values should be calculated by fetching each fertilizer and applying the weighted average.
-   *
-   * @example
-   * // For a blend:
-   * {
-   *   "primary_fertilizer_id": 1,    // Acti-Sol (70%)
-   *   "primary_fertilizer_ratio": 70,
-   *   "secondary_fertilizer_id": 12,  // Bionik (30%)
-   *   "secondary_fertilizer_ratio": 30
-   * }
-   *
-   * // For a single fertilizer:
-   * {}
-   */
-  combination_details: BlendCompositionI | null
-}
-
-interface BlendCompositionI {
-  primary_fertilizer_id: number
-  primary_fertilizer_ratio: number
-  secondary_fertilizer_id: number
-  secondary_fertilizer_ratio: number
-}
-
-export interface FertilizerSectionI {
-  sectionTitle: string
-  sectionSubtitle: string
-  fertilizers: FertilizerI[]
-}
-
-export interface FertilizersInGridI {
-  fertilizerSection: FertilizerSectionI[]
-}
+export interface FertilizerI {
+  id: number
+  name: string
+  slug: string
+  azotePercentage: number
+  phosphorePercentage: number
+  potassiumPercentage: number
+  /**
+   * The real azote percentage is the azote percentage multiplied by the azote efficiency.
+   */
+  realAzotePercentage: number
+  /**
+   * Nitrogen mineralization rate, between 0 and 1 (e.g. 0.9 for 90%).
+   */
+  nitrogenMineralizationRate: number | null
+  imageLocation: string
+  imageURL: string
+  quantitySuggested: string
+  /**
+   * Blend composition when this fertilizer is a combination of two products.
+   * Null for single fertilizers.
+   * When populated, contains the IDs and ratios (as percentages) of the primary and secondary fertilizers.
+   * The NPK values should be calculated by fetching each fertilizer and applying the weighted average.
+   *
+   * @example
+   * // For a blend:
+   * {
+   *   "primary_fertilizer_id": 1,    // Acti-Sol (70%)
+   *   "primary_fertilizer_ratio": 70,
+   *   "secondary_fertilizer_id": 12,  // Bionik (30%)
+   *   "secondary_fertilizer_ratio": 30
+   * }
+   *
+   * // For a single fertilizer:
+   * {}
+   */
+  combination_details: BlendCompositionI | null
+}
+
+interface BlendCompositionI {
+  primary_fertilizer_id: number
+  primary_fertilizer_ratio: number
+  secondary_fertilizer_id: number
+  secondary_fertilizer_ratio: number
+}
+
+export interface FertilizerSectionI {
+  sectionTitle: string
+  sectionSubtitle: string
+  fertilizers: FertilizerI[]
+}
+
+export interface FertilizersInGridI {
+  fertilizerSection: FertilizerSectionI[]
+}

package/src/index.ts

@@ -1,32 +1,34 @@
-export * from './member'
-export * from './selection'
-export * from './plantSelection'
-export * from './plant'
-export * from './task'
-export * from './calendarView'
-export * from './apiError'
-export * from './gardenMap'
-export * from './gardenOverview'
-export * from './alert'
-export * from './image'
-export * from './note'
-export * from './taggedItem'
-export * from './fertilizer'
-export * from './utmParams'
-export * from './plantFilters'
-import * as PlantsAPI from './plants.api'
-import * as UsersAPI from './users.api'
-import * as SessionsAPI from './sessions.api'
-import * as HomeAPI from './home.api'
-import * as PagesAPI from './pages.api'
-import * as PaymentsAPI from './payments.api'
-
-// Allow access to the API namespaces without conflicts
-export namespace API {
-  export import PLANTS = PlantsAPI
-  export import USERS = UsersAPI
-  export import SESSIONS = SessionsAPI
-  export import HOME = HomeAPI
-  export import PAGES = PagesAPI
-  export import PAYMENTS = PaymentsAPI
-}
+export * from './member'
+export * from './selection'
+export * from './plantSelection'
+export * from './plant'
+export * from './task'
+export * from './calendarView'
+export * from './apiError'
+export * from './gardenMap'
+export * from './gardenOverview'
+export * from './alert'
+export * from './image'
+export * from './note'
+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'
+import * as HomeAPI from './home.api'
+import * as PagesAPI from './pages.api'
+import * as PaymentsAPI from './payments.api'
+
+// Allow access to the API namespaces without conflicts
+export namespace API {
+  export import PLANTS = PlantsAPI
+  export import USERS = UsersAPI
+  export import SESSIONS = SessionsAPI
+  export import HOME = HomeAPI
+  export import PAGES = PagesAPI
+  export import PAYMENTS = PaymentsAPI
+}

package/src/plant.d.ts

@@ -1,6 +1,7 @@
 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
  */
@@ -98,9 +99,16 @@ export interface PlantI {
   Images?: ImageI[]
   Member?: Partial<MemberI>
   notes?: NoteI[]
-  rotationGroup?: string
-  // @deprecate once v1.8.1 is fully adopted
-  rotationFamily?: string
+  /**
+   * 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
   /**
@@ -123,6 +131,33 @@ interface PlantInventoryI {
 
 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[]
 }
@@ -137,4 +172,18 @@ export interface PlantSearchResultI {
   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/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
+}