@wasto/cms-components 1.5.10 → 1.5.11

package/README.md

@@ -1,47 +1,47 @@
-# @wasto/cms-components
-
-Composants CMS pour apps Expo / React Native (New Architecture, Bridgeless).
-
-Metro doit charger le **source** (`src/`, champ `"react-native"`), pas seulement `dist/`. Ne pas forcer `react-native-safe-area-context/lib/commonjs` dans `metro.config.js` : ça casse le codegen Fabric (`RNCSafeArea*`).
-
-## Peers
-
-| Package | Obligatoire | Notes |
-|--------|-------------|--------|
-| `react`, `react-native` | oui | RN 0.81+ / Expo 54+ |
-| `react-native-safe-area-context` | oui | `~5.6.0` — une seule copie, hoisted |
-| `@react-navigation/bottom-tabs` | oui | Types `BottomTab` (tabBar) |
-| `expo-image`, `lucide-react-native`, `@react-native-async-storage/async-storage`, `@wasto/sdk` | oui | |
-| `expo-router` | **optionnel** | Apps Expo Router : fournir `NavigationProvider` qui délègue à `router` |
-| `@maplibre/maplibre-react-native` | **optionnel** | Requis sur iOS/Android pour afficher la carte |
-| `maplibre-gl` | **optionnel** | Requis sur **web** (PWA / playground) pour la carte tuiles |
-
-### Navigation
-
-`Header` / `NextCollection` n’importent plus `expo-router`. L’hôte enveloppe l’app avec `NavigationProvider` :
-
-```tsx
-import { NavigationProvider } from "@wasto/cms-components";
-import { router } from "expo-router"; // ou React Navigation
-
-<NavigationProvider
-  value={{
-    push: (href) => router.push(href as never),
-    canGoBack: () => router.canGoBack(),
-    goBack: () => router.back(),
-  }}
->
-  …
-</NavigationProvider>
-```
-
-## Carte (`LocationsMap`)
-
-```ts
-import { LocationsMap } from "@wasto/cms-components"
-```
-
-- **iOS / Android** : Metro charge `LocationsMap.native.tsx` (MapLibre React Native).
-- **Web** : Metro charge `LocationsMapView.web.tsx` (MapLibre GL JS, style OpenFreeMap) si `maplibre-gl` est installé ; sinon fallback pins (`LocationsMapView.tsx`).
-
-Sur native : dépendance + plugin Expo `@maplibre/maplibre-react-native`, puis rebuild (`expo run:ios`). pnpm : le module doit être résolvable depuis la racine (`shamefully-hoist` ou `extraNodeModules`).
+# @wasto/cms-components
+
+Composants CMS pour apps Expo / React Native (New Architecture, Bridgeless).
+
+Metro doit charger le **source** (`src/`, champ `"react-native"`), pas seulement `dist/`. Ne pas forcer `react-native-safe-area-context/lib/commonjs` dans `metro.config.js` : ça casse le codegen Fabric (`RNCSafeArea*`).
+
+## Peers
+
+| Package | Obligatoire | Notes |
+|--------|-------------|--------|
+| `react`, `react-native` | oui | RN 0.81+ / Expo 54+ |
+| `react-native-safe-area-context` | oui | `~5.6.0` — une seule copie, hoisted |
+| `@react-navigation/bottom-tabs` | oui | Types `BottomTab` (tabBar) |
+| `expo-image`, `lucide-react-native`, `@react-native-async-storage/async-storage`, `@wasto/sdk` | oui | |
+| `expo-router` | **optionnel** | Apps Expo Router : fournir `NavigationProvider` qui délègue à `router` |
+| `@maplibre/maplibre-react-native` | **optionnel** | Requis sur iOS/Android pour afficher la carte |
+| `maplibre-gl` | **optionnel** | Requis sur **web** (PWA / playground) pour la carte tuiles |
+
+### Navigation
+
+`Header` / `NextCollection` n’importent plus `expo-router`. L’hôte enveloppe l’app avec `NavigationProvider` :
+
+```tsx
+import { NavigationProvider } from "@wasto/cms-components";
+import { router } from "expo-router"; // ou React Navigation
+
+<NavigationProvider
+  value={{
+    push: (href) => router.push(href as never),
+    canGoBack: () => router.canGoBack(),
+    goBack: () => router.back(),
+  }}
+>
+  …
+</NavigationProvider>
+```
+
+## Carte (`LocationsMap`)
+
+```ts
+import { LocationsMap } from "@wasto/cms-components"
+```
+
+- **iOS / Android** : Metro charge `LocationsMap.native.tsx` (MapLibre React Native).
+- **Web** : Metro charge `LocationsMapView.web.tsx` (MapLibre GL JS, style OpenFreeMap) si `maplibre-gl` est installé ; sinon fallback pins (`LocationsMapView.tsx`).
+
+Sur native : dépendance + plugin Expo `@maplibre/maplibre-react-native`, puis rebuild (`expo run:ios`). pnpm : le module doit être résolvable depuis la racine (`shamefully-hoist` ou `extraNodeModules`).

package/dist/index.d.mts

@@ -65,6 +65,31 @@ type ImageUrlProps = {
 type ImageProps = ImageUrlProps | ImageMediaProps;
 declare function Image(props: ImageProps): ReactNode;
 
+type HoursDayRow = {
+    label: string;
+    hours: string;
+    closed: boolean;
+};
+type HoursStatus = {
+    open: boolean;
+    text: string;
+};
+
+type LocationCategory = "recycling" | "decheterie" | "collection_place" | "sorting_center";
+type MapLocation = {
+    id: string;
+    name: string;
+    category: LocationCategory;
+    address?: string;
+    phone?: string;
+    hoursDisplay?: string;
+    hoursRows?: HoursDayRow[];
+    hoursStatus?: HoursStatus | null;
+    lat: number;
+    lon: number;
+    badges?: string[];
+};
+
 type LocationsMapProps = {
     fullScreen?: boolean;
     showFilters?: boolean;
@@ -94,13 +119,18 @@ declare function NextCollection({ calendarHref, showCalendarCta, dayOffset, }: N
 type PageProps = PropsWithChildren & {
     /** When false, content fills the screen without scrolling (e.g. fullScreen map). Default true. */
     scroll?: boolean;
+    /**
+     * Pull-to-refresh : force refresh du cache tri + carte (TTL 1 semaine).
+     * Default true when scrollable.
+     */
+    pullToRefresh?: boolean;
 };
 /**
  * Page shell: top safe area + optional vertical scroll.
  * No global horizontal padding — each block uses ContentInset or is full-bleed
  * (map, calendar grid). Bottom inset is handled by BottomTab when using tabs.
  */
-declare function Page({ children, scroll }: PageProps): ReactNode;
+declare function Page({ children, scroll, pullToRefresh, }: PageProps): ReactNode;
 
 type ContentInsetProps = PropsWithChildren & {
     /** Use 12px horizontal instead of 16px */
@@ -360,6 +390,77 @@ type WastoProviderProps = PropsWithChildren & {
 declare function WastoProvider(props: WastoProviderProps): ReactNode;
 declare function useWasto(): WastoContextType;
 
+type City = {
+    id: string;
+    name: string;
+    status?: "NON_ACTIF" | "INCOMPLET" | "ACTIF" | "MAINTENANCE";
+    [key: string]: unknown;
+};
+type WasteType = {
+    id: string;
+    name?: string;
+    icon?: string;
+    imageUrl?: string | null;
+    color?: string;
+    [key: string]: unknown;
+};
+type WasteCollectionPlace = {
+    id: string;
+    name?: string;
+    collectionDays?: Array<{
+        /** Ex: "Lundi", "Mardi", ... (mapping lundi=0 … dimanche=6) */
+        name: string;
+        wasteTypeId: string;
+        biweekly?: boolean;
+        startDate?: string;
+    }>;
+    /** Périodes d’exception (pas de collecte) */
+    exceptions?: Array<{
+        dateFrom: string;
+        dateTo: string;
+    }>;
+    [key: string]: unknown;
+};
+type CollectionForDay = {
+    id: string;
+    name: string;
+    icon?: string;
+    imageUrl?: string | null;
+    color?: string;
+    contrastColor?: "#000000" | "#FFFFFF";
+};
+
+/** Fenêtre préchargée pour le carrousel « prochaines collectes ». */
+declare const NEXT_EVENTS_DAY_RADIUS = 3;
+type AppDataContextType = {
+    /** True tant que events ±3j + mois calendrier ne sont pas prêts (loader post-splash). */
+    isBootstrapping: boolean;
+    city: City | null;
+    wasteTypes: WasteType[];
+    wasteCollectionPlaces: WasteCollectionPlace[];
+    /** Collectes précalculées pour offsets -3 … +3. */
+    nextEventsByOffset: Record<number, CollectionForDay[]>;
+    locations: MapLocation[];
+    mapCenter: {
+        lat: number;
+        lon: number;
+    };
+    isMapLoading: boolean;
+    isRecyclingLoading: boolean;
+    scheduleError: string | null;
+    mapError: string | null;
+    /**
+     * Force-refresh tri + carte (invalide le TTL).
+     * Utilisé par le pull-to-refresh.
+     */
+    refreshCachedData: () => Promise<void>;
+    /** Recharge events + calendrier (critique). */
+    refreshSchedule: () => Promise<void>;
+};
+declare function useAppData(): AppDataContextType;
+/** Safe variant for hooks that may run outside (preview / tests). */
+declare function useOptionalAppData(): AppDataContextType | null;
+
 /** Shared Wasto HTTP client wired with optional API error reporting. */
 declare function useWastoClient(): WastoClient;
 
@@ -462,4 +563,4 @@ declare function useAppNavigation(): NavigationApi;
 /** Soft read — returns null when no provider (e.g. isolated component tests). */
 declare function useOptionalAppNavigation(): NavigationApi | null;
 
-export { type AppHeaderActionElement, type AppHeaderConfig, type AppHeaderElement, type AppHeaderLogoElement, type AppHeaderSlot, type AppHeaderTitleElement, Article, type ArticleDisplayMode, type ArticleProps, BottomTab, type BottomTabProps, Challenge, type ChallengeProps, ChallengeVignette, type ChallengeVignetteProps, Chat, type ChatProps, CollectionCalendar, type CollectionCalendarProps, Columns, type ColumnsColumnCount, type ColumnsProps, ContentInset, type ContentInsetProps, Header, type HeaderProps, Image, type ImageProps, LocationsMap, type LocationsMapProps, MAQUETTE_COLORS, MAQUETTE_RADII, type NavigationApi, NavigationProvider, type NavigationProviderProps, NextCollection, type NextCollectionProps, NotificationsScreen, Page, type PageProps, Paragraph, type PararaphProps, ProfileScreen, RecyclingInfo, type RecyclingInfoProps, type ResolvedTheme, SPACE, SYSTEM_ROUTES, Search, type SearchProps, type SystemRouteKey, type Theme, type ThemeShadowStyle, Title, type TitleLevel, type TitleProps, Vision, type VisionActionCardProps, type VisionCaptureResult, type VisionProps, type VisionSuggestion, type WastoContextType, type WastoErrorContext, WastoProvider, type WastoProviderProps, type WastoSentryConfig, cardStyle, coloredShadow, createMaquetteTheme, groupedSectionStyle, initWastoSentry, isWastoSentryActive, reportError, resolveTheme, softCardStyle, useAppNavigation, useOptionalAppNavigation, useWasto, useWastoClient, wrapWithSentry };
+export { type AppDataContextType, type AppHeaderActionElement, type AppHeaderConfig, type AppHeaderElement, type AppHeaderLogoElement, type AppHeaderSlot, type AppHeaderTitleElement, Article, type ArticleDisplayMode, type ArticleProps, BottomTab, type BottomTabProps, Challenge, type ChallengeProps, ChallengeVignette, type ChallengeVignetteProps, Chat, type ChatProps, CollectionCalendar, type CollectionCalendarProps, Columns, type ColumnsColumnCount, type ColumnsProps, ContentInset, type ContentInsetProps, Header, type HeaderProps, Image, type ImageProps, LocationsMap, type LocationsMapProps, MAQUETTE_COLORS, MAQUETTE_RADII, NEXT_EVENTS_DAY_RADIUS, type NavigationApi, NavigationProvider, type NavigationProviderProps, NextCollection, type NextCollectionProps, NotificationsScreen, Page, type PageProps, Paragraph, type PararaphProps, ProfileScreen, RecyclingInfo, type RecyclingInfoProps, type ResolvedTheme, SPACE, SYSTEM_ROUTES, Search, type SearchProps, type SystemRouteKey, type Theme, type ThemeShadowStyle, Title, type TitleLevel, type TitleProps, Vision, type VisionActionCardProps, type VisionCaptureResult, type VisionProps, type VisionSuggestion, type WastoContextType, type WastoErrorContext, WastoProvider, type WastoProviderProps, type WastoSentryConfig, cardStyle, coloredShadow, createMaquetteTheme, groupedSectionStyle, initWastoSentry, isWastoSentryActive, reportError, resolveTheme, softCardStyle, useAppData, useAppNavigation, useOptionalAppData, useOptionalAppNavigation, useWasto, useWastoClient, wrapWithSentry };

package/dist/index.d.ts

@@ -65,6 +65,31 @@ type ImageUrlProps = {
 type ImageProps = ImageUrlProps | ImageMediaProps;
 declare function Image(props: ImageProps): ReactNode;
 
+type HoursDayRow = {
+    label: string;
+    hours: string;
+    closed: boolean;
+};
+type HoursStatus = {
+    open: boolean;
+    text: string;
+};
+
+type LocationCategory = "recycling" | "decheterie" | "collection_place" | "sorting_center";
+type MapLocation = {
+    id: string;
+    name: string;
+    category: LocationCategory;
+    address?: string;
+    phone?: string;
+    hoursDisplay?: string;
+    hoursRows?: HoursDayRow[];
+    hoursStatus?: HoursStatus | null;
+    lat: number;
+    lon: number;
+    badges?: string[];
+};
+
 type LocationsMapProps = {
     fullScreen?: boolean;
     showFilters?: boolean;
@@ -94,13 +119,18 @@ declare function NextCollection({ calendarHref, showCalendarCta, dayOffset, }: N
 type PageProps = PropsWithChildren & {
     /** When false, content fills the screen without scrolling (e.g. fullScreen map). Default true. */
     scroll?: boolean;
+    /**
+     * Pull-to-refresh : force refresh du cache tri + carte (TTL 1 semaine).
+     * Default true when scrollable.
+     */
+    pullToRefresh?: boolean;
 };
 /**
  * Page shell: top safe area + optional vertical scroll.
  * No global horizontal padding — each block uses ContentInset or is full-bleed
  * (map, calendar grid). Bottom inset is handled by BottomTab when using tabs.
  */
-declare function Page({ children, scroll }: PageProps): ReactNode;
+declare function Page({ children, scroll, pullToRefresh, }: PageProps): ReactNode;
 
 type ContentInsetProps = PropsWithChildren & {
     /** Use 12px horizontal instead of 16px */
@@ -360,6 +390,77 @@ type WastoProviderProps = PropsWithChildren & {
 declare function WastoProvider(props: WastoProviderProps): ReactNode;
 declare function useWasto(): WastoContextType;
 
+type City = {
+    id: string;
+    name: string;
+    status?: "NON_ACTIF" | "INCOMPLET" | "ACTIF" | "MAINTENANCE";
+    [key: string]: unknown;
+};
+type WasteType = {
+    id: string;
+    name?: string;
+    icon?: string;
+    imageUrl?: string | null;
+    color?: string;
+    [key: string]: unknown;
+};
+type WasteCollectionPlace = {
+    id: string;
+    name?: string;
+    collectionDays?: Array<{
+        /** Ex: "Lundi", "Mardi", ... (mapping lundi=0 … dimanche=6) */
+        name: string;
+        wasteTypeId: string;
+        biweekly?: boolean;
+        startDate?: string;
+    }>;
+    /** Périodes d’exception (pas de collecte) */
+    exceptions?: Array<{
+        dateFrom: string;
+        dateTo: string;
+    }>;
+    [key: string]: unknown;
+};
+type CollectionForDay = {
+    id: string;
+    name: string;
+    icon?: string;
+    imageUrl?: string | null;
+    color?: string;
+    contrastColor?: "#000000" | "#FFFFFF";
+};
+
+/** Fenêtre préchargée pour le carrousel « prochaines collectes ». */
+declare const NEXT_EVENTS_DAY_RADIUS = 3;
+type AppDataContextType = {
+    /** True tant que events ±3j + mois calendrier ne sont pas prêts (loader post-splash). */
+    isBootstrapping: boolean;
+    city: City | null;
+    wasteTypes: WasteType[];
+    wasteCollectionPlaces: WasteCollectionPlace[];
+    /** Collectes précalculées pour offsets -3 … +3. */
+    nextEventsByOffset: Record<number, CollectionForDay[]>;
+    locations: MapLocation[];
+    mapCenter: {
+        lat: number;
+        lon: number;
+    };
+    isMapLoading: boolean;
+    isRecyclingLoading: boolean;
+    scheduleError: string | null;
+    mapError: string | null;
+    /**
+     * Force-refresh tri + carte (invalide le TTL).
+     * Utilisé par le pull-to-refresh.
+     */
+    refreshCachedData: () => Promise<void>;
+    /** Recharge events + calendrier (critique). */
+    refreshSchedule: () => Promise<void>;
+};
+declare function useAppData(): AppDataContextType;
+/** Safe variant for hooks that may run outside (preview / tests). */
+declare function useOptionalAppData(): AppDataContextType | null;
+
 /** Shared Wasto HTTP client wired with optional API error reporting. */
 declare function useWastoClient(): WastoClient;
 
@@ -462,4 +563,4 @@ declare function useAppNavigation(): NavigationApi;
 /** Soft read — returns null when no provider (e.g. isolated component tests). */
 declare function useOptionalAppNavigation(): NavigationApi | null;
 
-export { type AppHeaderActionElement, type AppHeaderConfig, type AppHeaderElement, type AppHeaderLogoElement, type AppHeaderSlot, type AppHeaderTitleElement, Article, type ArticleDisplayMode, type ArticleProps, BottomTab, type BottomTabProps, Challenge, type ChallengeProps, ChallengeVignette, type ChallengeVignetteProps, Chat, type ChatProps, CollectionCalendar, type CollectionCalendarProps, Columns, type ColumnsColumnCount, type ColumnsProps, ContentInset, type ContentInsetProps, Header, type HeaderProps, Image, type ImageProps, LocationsMap, type LocationsMapProps, MAQUETTE_COLORS, MAQUETTE_RADII, type NavigationApi, NavigationProvider, type NavigationProviderProps, NextCollection, type NextCollectionProps, NotificationsScreen, Page, type PageProps, Paragraph, type PararaphProps, ProfileScreen, RecyclingInfo, type RecyclingInfoProps, type ResolvedTheme, SPACE, SYSTEM_ROUTES, Search, type SearchProps, type SystemRouteKey, type Theme, type ThemeShadowStyle, Title, type TitleLevel, type TitleProps, Vision, type VisionActionCardProps, type VisionCaptureResult, type VisionProps, type VisionSuggestion, type WastoContextType, type WastoErrorContext, WastoProvider, type WastoProviderProps, type WastoSentryConfig, cardStyle, coloredShadow, createMaquetteTheme, groupedSectionStyle, initWastoSentry, isWastoSentryActive, reportError, resolveTheme, softCardStyle, useAppNavigation, useOptionalAppNavigation, useWasto, useWastoClient, wrapWithSentry };
+export { type AppDataContextType, type AppHeaderActionElement, type AppHeaderConfig, type AppHeaderElement, type AppHeaderLogoElement, type AppHeaderSlot, type AppHeaderTitleElement, Article, type ArticleDisplayMode, type ArticleProps, BottomTab, type BottomTabProps, Challenge, type ChallengeProps, ChallengeVignette, type ChallengeVignetteProps, Chat, type ChatProps, CollectionCalendar, type CollectionCalendarProps, Columns, type ColumnsColumnCount, type ColumnsProps, ContentInset, type ContentInsetProps, Header, type HeaderProps, Image, type ImageProps, LocationsMap, type LocationsMapProps, MAQUETTE_COLORS, MAQUETTE_RADII, NEXT_EVENTS_DAY_RADIUS, type NavigationApi, NavigationProvider, type NavigationProviderProps, NextCollection, type NextCollectionProps, NotificationsScreen, Page, type PageProps, Paragraph, type PararaphProps, ProfileScreen, RecyclingInfo, type RecyclingInfoProps, type ResolvedTheme, SPACE, SYSTEM_ROUTES, Search, type SearchProps, type SystemRouteKey, type Theme, type ThemeShadowStyle, Title, type TitleLevel, type TitleProps, Vision, type VisionActionCardProps, type VisionCaptureResult, type VisionProps, type VisionSuggestion, type WastoContextType, type WastoErrorContext, WastoProvider, type WastoProviderProps, type WastoSentryConfig, cardStyle, coloredShadow, createMaquetteTheme, groupedSectionStyle, initWastoSentry, isWastoSentryActive, reportError, resolveTheme, softCardStyle, useAppData, useAppNavigation, useOptionalAppData, useOptionalAppNavigation, useWasto, useWastoClient, wrapWithSentry };