@wasto/cms-components 1.5.10 → 1.5.12

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,12 +65,96 @@ 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 AppHeaderSlot = "left" | "center" | "right";
+type AppHeaderLogoElement = {
+    id: string;
+    type: "logo";
+    slot: AppHeaderSlot;
+    sourceType: "url" | "media";
+    url?: string;
+    mediaId?: string;
+};
+type AppHeaderTitleElement = {
+    id: string;
+    type: "title";
+    slot: AppHeaderSlot;
+    useScreenTitle?: boolean;
+    text?: string;
+};
+type AppHeaderActionElement = {
+    id: string;
+    type: "action";
+    slot: AppHeaderSlot;
+    icon: string;
+    label?: string;
+    action: "navigate" | "back";
+    href?: string;
+};
+type AppHeaderElement = AppHeaderLogoElement | AppHeaderTitleElement | AppHeaderActionElement;
+type AppHeaderConfig = {
+    elements: AppHeaderElement[];
+};
+/** Actions standard (notifications + profil) pour navbar sans titre. */
+declare const DEFAULT_HEADER_ACTIONS: readonly AppHeaderActionElement[];
+type HeaderProps = {
+    readonly options: {
+        title?: string;
+        headerBackVisible?: boolean;
+    };
+    readonly route: {
+        name: string;
+    };
+    readonly navigation: {
+        canGoBack: () => boolean;
+        goBack: () => void;
+    };
+    /** Flotte au-dessus du contenu (ex. carte) : fond transparent. */
+    readonly overlay?: boolean;
+    /**
+     * Config layout (`header.elements`) — logo / actions.
+     * Si fournie (même vide), le fallback titre d’écran ne s’applique pas.
+     */
+    readonly headerConfig?: AppHeaderConfig | null;
+};
+declare function Header({ options, route, navigation, overlay, headerConfig, }: HeaderProps): ReactNode;
+
 type LocationsMapProps = {
     fullScreen?: boolean;
     showFilters?: boolean;
-    /** Header flottant au-dessus de la carte (titre + cloche + profil). */
+    /** Header flottant au-dessus de la carte (même navbar que le layout, sans titre). */
     overlayHeader?: boolean;
+    /**
+     * @deprecated Ignoré — la navbar n’affiche plus de titre d’écran.
+     * Conservé pour compatibilité des configs CMS existantes.
+     */
     overlayTitle?: string;
+    /** Override optionnel ; sinon config du layout via `HeaderConfigProvider`. */
+    headerConfig?: AppHeaderConfig | null;
 };
 
 /**
@@ -94,13 +178,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 */
@@ -144,54 +233,6 @@ type SearchProps = {
 };
 declare function Search({ searchType, placeholder, }: SearchProps): ReactNode;
 
-type AppHeaderSlot = "left" | "center" | "right";
-type AppHeaderLogoElement = {
-    id: string;
-    type: "logo";
-    slot: AppHeaderSlot;
-    sourceType: "url" | "media";
-    url?: string;
-    mediaId?: string;
-};
-type AppHeaderTitleElement = {
-    id: string;
-    type: "title";
-    slot: AppHeaderSlot;
-    useScreenTitle?: boolean;
-    text?: string;
-};
-type AppHeaderActionElement = {
-    id: string;
-    type: "action";
-    slot: AppHeaderSlot;
-    icon: string;
-    label?: string;
-    action: "navigate" | "back";
-    href?: string;
-};
-type AppHeaderElement = AppHeaderLogoElement | AppHeaderTitleElement | AppHeaderActionElement;
-type AppHeaderConfig = {
-    elements: AppHeaderElement[];
-};
-type HeaderProps = {
-    readonly options: {
-        title?: string;
-        headerBackVisible?: boolean;
-    };
-    readonly route: {
-        name: string;
-    };
-    readonly navigation: {
-        canGoBack: () => boolean;
-        goBack: () => void;
-    };
-    /** Flotte au-dessus du contenu (ex. carte) : fond transparent. */
-    readonly overlay?: boolean;
-    /** Config layout (`header.elements`) — logo / titre / actions. */
-    readonly headerConfig?: AppHeaderConfig | null;
-};
-declare function Header({ options, route, navigation, overlay, headerConfig, }: HeaderProps): ReactNode;
-
 type BottomTabProps = BottomTabBarProps;
 declare function BottomTab({ state, descriptors, navigation, }: BottomTabProps): ReactNode;
 
@@ -360,6 +401,95 @@ type WastoProviderProps = PropsWithChildren & {
 declare function WastoProvider(props: WastoProviderProps): ReactNode;
 declare function useWasto(): WastoContextType;
 
+type HeaderConfigProviderProps = {
+    readonly value: AppHeaderConfig | null;
+    readonly children: ReactNode;
+};
+declare function HeaderConfigProvider({ value, children, }: HeaderConfigProviderProps): ReactNode;
+/** Config header du layout parent (`null` si hors provider / non défini). */
+declare function useHeaderConfig(): AppHeaderConfig | null;
+
+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;
+
+type RegisterExpoPushTokenOptions = {
+    deviceId: string;
+    registerPushToken: (deviceId: string, token: string) => Promise<unknown>;
+};
+/**
+ * Request OS permission, fetch Expo push token, register it on the API.
+ * No-op on web, preview, missing peer, missing EAS projectId, or denied permission.
+ */
+declare function registerExpoPushToken(options: RegisterExpoPushTokenOptions): Promise<string | null>;
+
 /** Shared Wasto HTTP client wired with optional API error reporting. */
 declare function useWastoClient(): WastoClient;
 
@@ -462,4 +592,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, DEFAULT_HEADER_ACTIONS, Header, HeaderConfigProvider, type HeaderConfigProviderProps, 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 RegisterExpoPushTokenOptions, 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, registerExpoPushToken, reportError, resolveTheme, softCardStyle, useAppData, useAppNavigation, useHeaderConfig, useOptionalAppData, useOptionalAppNavigation, useWasto, useWastoClient, wrapWithSentry };

package/dist/index.d.ts

@@ -65,12 +65,96 @@ 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 AppHeaderSlot = "left" | "center" | "right";
+type AppHeaderLogoElement = {
+    id: string;
+    type: "logo";
+    slot: AppHeaderSlot;
+    sourceType: "url" | "media";
+    url?: string;
+    mediaId?: string;
+};
+type AppHeaderTitleElement = {
+    id: string;
+    type: "title";
+    slot: AppHeaderSlot;
+    useScreenTitle?: boolean;
+    text?: string;
+};
+type AppHeaderActionElement = {
+    id: string;
+    type: "action";
+    slot: AppHeaderSlot;
+    icon: string;
+    label?: string;
+    action: "navigate" | "back";
+    href?: string;
+};
+type AppHeaderElement = AppHeaderLogoElement | AppHeaderTitleElement | AppHeaderActionElement;
+type AppHeaderConfig = {
+    elements: AppHeaderElement[];
+};
+/** Actions standard (notifications + profil) pour navbar sans titre. */
+declare const DEFAULT_HEADER_ACTIONS: readonly AppHeaderActionElement[];
+type HeaderProps = {
+    readonly options: {
+        title?: string;
+        headerBackVisible?: boolean;
+    };
+    readonly route: {
+        name: string;
+    };
+    readonly navigation: {
+        canGoBack: () => boolean;
+        goBack: () => void;
+    };
+    /** Flotte au-dessus du contenu (ex. carte) : fond transparent. */
+    readonly overlay?: boolean;
+    /**
+     * Config layout (`header.elements`) — logo / actions.
+     * Si fournie (même vide), le fallback titre d’écran ne s’applique pas.
+     */
+    readonly headerConfig?: AppHeaderConfig | null;
+};
+declare function Header({ options, route, navigation, overlay, headerConfig, }: HeaderProps): ReactNode;
+
 type LocationsMapProps = {
     fullScreen?: boolean;
     showFilters?: boolean;
-    /** Header flottant au-dessus de la carte (titre + cloche + profil). */
+    /** Header flottant au-dessus de la carte (même navbar que le layout, sans titre). */
     overlayHeader?: boolean;
+    /**
+     * @deprecated Ignoré — la navbar n’affiche plus de titre d’écran.
+     * Conservé pour compatibilité des configs CMS existantes.
+     */
     overlayTitle?: string;
+    /** Override optionnel ; sinon config du layout via `HeaderConfigProvider`. */
+    headerConfig?: AppHeaderConfig | null;
 };
 
 /**
@@ -94,13 +178,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 */
@@ -144,54 +233,6 @@ type SearchProps = {
 };
 declare function Search({ searchType, placeholder, }: SearchProps): ReactNode;
 
-type AppHeaderSlot = "left" | "center" | "right";
-type AppHeaderLogoElement = {
-    id: string;
-    type: "logo";
-    slot: AppHeaderSlot;
-    sourceType: "url" | "media";
-    url?: string;
-    mediaId?: string;
-};
-type AppHeaderTitleElement = {
-    id: string;
-    type: "title";
-    slot: AppHeaderSlot;
-    useScreenTitle?: boolean;
-    text?: string;
-};
-type AppHeaderActionElement = {
-    id: string;
-    type: "action";
-    slot: AppHeaderSlot;
-    icon: string;
-    label?: string;
-    action: "navigate" | "back";
-    href?: string;
-};
-type AppHeaderElement = AppHeaderLogoElement | AppHeaderTitleElement | AppHeaderActionElement;
-type AppHeaderConfig = {
-    elements: AppHeaderElement[];
-};
-type HeaderProps = {
-    readonly options: {
-        title?: string;
-        headerBackVisible?: boolean;
-    };
-    readonly route: {
-        name: string;
-    };
-    readonly navigation: {
-        canGoBack: () => boolean;
-        goBack: () => void;
-    };
-    /** Flotte au-dessus du contenu (ex. carte) : fond transparent. */
-    readonly overlay?: boolean;
-    /** Config layout (`header.elements`) — logo / titre / actions. */
-    readonly headerConfig?: AppHeaderConfig | null;
-};
-declare function Header({ options, route, navigation, overlay, headerConfig, }: HeaderProps): ReactNode;
-
 type BottomTabProps = BottomTabBarProps;
 declare function BottomTab({ state, descriptors, navigation, }: BottomTabProps): ReactNode;
 
@@ -360,6 +401,95 @@ type WastoProviderProps = PropsWithChildren & {
 declare function WastoProvider(props: WastoProviderProps): ReactNode;
 declare function useWasto(): WastoContextType;
 
+type HeaderConfigProviderProps = {
+    readonly value: AppHeaderConfig | null;
+    readonly children: ReactNode;
+};
+declare function HeaderConfigProvider({ value, children, }: HeaderConfigProviderProps): ReactNode;
+/** Config header du layout parent (`null` si hors provider / non défini). */
+declare function useHeaderConfig(): AppHeaderConfig | null;
+
+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;
+
+type RegisterExpoPushTokenOptions = {
+    deviceId: string;
+    registerPushToken: (deviceId: string, token: string) => Promise<unknown>;
+};
+/**
+ * Request OS permission, fetch Expo push token, register it on the API.
+ * No-op on web, preview, missing peer, missing EAS projectId, or denied permission.
+ */
+declare function registerExpoPushToken(options: RegisterExpoPushTokenOptions): Promise<string | null>;
+
 /** Shared Wasto HTTP client wired with optional API error reporting. */
 declare function useWastoClient(): WastoClient;
 
@@ -462,4 +592,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, DEFAULT_HEADER_ACTIONS, Header, HeaderConfigProvider, type HeaderConfigProviderProps, 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 RegisterExpoPushTokenOptions, 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, registerExpoPushToken, reportError, resolveTheme, softCardStyle, useAppData, useAppNavigation, useHeaderConfig, useOptionalAppData, useOptionalAppNavigation, useWasto, useWastoClient, wrapWithSentry };