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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@la-main-verte/shared-types",
-  "version": "1.0.79",
+  "version": "1.0.81",
   "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/plant.d.ts

@@ -59,6 +59,26 @@ export interface PlantI {
   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
@@ -103,6 +123,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[]
 }
@@ -117,4 +164,5 @@ export interface PlantSearchResultI {
   selections: SelectionModelI[]
   total?: number
   familyName?: string
+  filtersUI?: PlantFiltersUII
 }