@wasto/cms-components 1.5.11 → 1.5.14

package/dist/index.d.mts

@@ -90,12 +90,71 @@ type MapLocation = {
     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;
 };
 
 /**
@@ -126,7 +185,8 @@ type PageProps = PropsWithChildren & {
     pullToRefresh?: boolean;
 };
 /**
- * Page shell: top safe area + optional vertical scroll.
+ * Page shell: optional vertical scroll.
+ * Top safe area only when no navigation header (avoids a double inset band).
  * No global horizontal padding — each block uses ContentInset or is full-bleed
  * (map, calendar grid). Bottom inset is handled by BottomTab when using tabs.
  */
@@ -174,54 +234,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;
 
@@ -390,6 +402,14 @@ 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;
@@ -411,7 +431,7 @@ type WasteCollectionPlace = {
         /** Ex: "Lundi", "Mardi", ... (mapping lundi=0 … dimanche=6) */
         name: string;
         wasteTypeId: string;
-        biweekly?: boolean;
+        everyWeeks?: number;
         startDate?: string;
     }>;
     /** Périodes d’exception (pas de collecte) */
@@ -461,6 +481,16 @@ 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;
 
@@ -563,4 +593,4 @@ declare function useAppNavigation(): NavigationApi;
 /** Soft read — returns null when no provider (e.g. isolated component tests). */
 declare function useOptionalAppNavigation(): NavigationApi | null;
 
-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 };
+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

@@ -90,12 +90,71 @@ type MapLocation = {
     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;
 };
 
 /**
@@ -126,7 +185,8 @@ type PageProps = PropsWithChildren & {
     pullToRefresh?: boolean;
 };
 /**
- * Page shell: top safe area + optional vertical scroll.
+ * Page shell: optional vertical scroll.
+ * Top safe area only when no navigation header (avoids a double inset band).
  * No global horizontal padding — each block uses ContentInset or is full-bleed
  * (map, calendar grid). Bottom inset is handled by BottomTab when using tabs.
  */
@@ -174,54 +234,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;
 
@@ -390,6 +402,14 @@ 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;
@@ -411,7 +431,7 @@ type WasteCollectionPlace = {
         /** Ex: "Lundi", "Mardi", ... (mapping lundi=0 … dimanche=6) */
         name: string;
         wasteTypeId: string;
-        biweekly?: boolean;
+        everyWeeks?: number;
         startDate?: string;
     }>;
     /** Périodes d’exception (pas de collecte) */
@@ -461,6 +481,16 @@ 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;
 
@@ -563,4 +593,4 @@ declare function useAppNavigation(): NavigationApi;
 /** Soft read — returns null when no provider (e.g. isolated component tests). */
 declare function useOptionalAppNavigation(): NavigationApi | null;
 
-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 };
+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 };