@la-main-verte/shared-types 1.0.64 → 1.0.66

package/package.json

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

package/src/gardenMap.d.ts

@@ -45,6 +45,11 @@ export interface GardenZoneI {
   yPosition: number
   zIndex: number
   order: number
+  /**
+   * When set, the zone is shown only for that year.
+   * Null means the zone is timeless (visible for every year).
+   */
+  yearOfCulture: number | null
   totalSurfaceInSquareMeters: number
   totalSurfaceInSquareFeet: number
   backgroundColor: string
@@ -62,6 +67,7 @@ export interface GardenZoneI {
    */
   is_subdivision: boolean
   has_subdivisions: boolean
+  timeless: boolean
   /**
    * Orientation virtual field ONLY USE FOR RECTANGLES
    * --------------------------------
@@ -104,7 +110,6 @@ export interface GardenZoneCultureI {
    * Value is computed by the backend and NOT coming from the DB.
    */
   numberOfSeedsPerAlley?: number
-  fertilizerQuantitySuggested?: string
   Fertilizer?: FertilizerI
   custom_space_between_seeds_in_cm?: number
   custom_space_between_alley_in_cm?: number

package/src/home.api.d.ts

@@ -192,6 +192,25 @@ export namespace HOME {
     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
+  }
+
   export type SectionI =
     | HeaderSectionI
     | HeroCardsSectionI
@@ -202,6 +221,7 @@ export namespace HOME {
     | AdviceSectionI
     | OnboardingCardSectionI
     | UpcomingTasksSectionI
+    | LinkCardSectionI
 
   export interface Response {
     sections: SectionI[]

package/src/index.ts

@@ -18,6 +18,7 @@ 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'
 
 // Allow access to the API namespaces without conflicts
 export namespace API {
@@ -25,4 +26,5 @@ export namespace API {
   export import USERS = UsersAPI
   export import SESSIONS = SessionsAPI
   export import HOME = HomeAPI
+  export import PAGES = PagesAPI
 }

package/src/member.d.ts

@@ -46,6 +46,7 @@ export interface MemberI {
   finishedOnboarding: boolean
   hasDownloadedNativeApp?: boolean
   unitSystem: 'imperial' | 'metric'
+  gardenZoneTimelessPreference?: boolean
   subscriptionEndDate?: Date
   /**
    * Virtual field to get the app badge count

package/src/pages.api.d.ts

@@ -0,0 +1,36 @@
+import type { PlantI } from './plant'
+
+export namespace PAGES {
+  export interface SeedingTagI {
+    label: string
+    variant: string
+  }
+
+  export interface StartDateBadgeI {
+    day: string
+    month: string
+  }
+
+  export interface SeedingInfoI {
+    tags: SeedingTagI[]
+    startDateBadge: StartDateBadgeI | null
+    description: string | null
+  }
+
+  export interface SeedableFamiliesByMonthResponse {
+    title?: string | null
+    subtitle?: string | null
+    Plants: PlantI[]
+  }
+
+  export interface MonthPreviewI {
+    month: number
+    label: string
+    previewPlants: Pick<PlantI, 'id' | 'name' | 'family' | 'slug' | 'imageURL'>[]
+    totalFamiliesCount: number
+  }
+
+  export interface MonthsPreviewResponse {
+    months: MonthPreviewI[]
+  }
+}

package/src/plant.d.ts

@@ -1,4 +1,5 @@
 import type { TaxonFamilyI } from './taxonFamily'
+import type { SeedingInfoI } from './pages.api'
 /**
  * Range filter value for min/max filters
  */
@@ -76,6 +77,7 @@ export interface PlantI {
   // @deprecate once v1.8.1 is fully adopted
   rotationFamily?: string
   taxonFamily?: TaxonFamilyI
+  seedingInfo: SeedingInfoI
 }
 
 interface PlantTagI {

package/src/plantFilters.d.ts

@@ -1,6 +1,5 @@
 export interface PlantFiltersConfigI {
   filters: PlantFilterI[]
-  helpText?: string
 }
 
 export interface PlantFilterI {
@@ -11,9 +10,31 @@ export interface PlantFilterI {
   options?: FilterOptionI[] // For select/multiselect
   min?: number // For range
   max?: number // For range
+  /** General help text for this filter attribute (always displayed) */
+  helpText?: string
+  /** Contextual help text based on member profile (displayed when relevant) */
+  contextualHelpText?: string
 }
 
 export interface FilterOptionI {
   value: string
   label: string
+  /** General help text for this option (always displayed) */
+  helpText?: string
+  /** Contextual help text based on member profile (displayed when relevant) */
+  contextualHelpText?: string
+}
+
+/**
+ * Member context used to generate contextual help texts
+ */
+export interface MemberFilterContextI {
+  /** Hardiness zone index (e.g., 30, 40, 50) - null if not available */
+  hardinessZoneIndex: number | null
+  /** Hardiness zone name (e.g., "4a", "5b") - null if not available */
+  hardinessZoneName: string | null
+  /** Whether the member has a greenhouse */
+  hasGreenhouse: boolean
+  /** Whether the member has a balcony */
+  hasBalcony: boolean
 }