@bytebrand/fe-ui-core-autobahn 1.0.1 → 1.0.3

package/cards/index.ts

@@ -1,35 +1,37 @@
-// Autobahn (auto.de redesign) — car cards barrel.
-//
-// ES named exports replacing the design kit's `Object.assign(window, {...})`
-// (docs/redesign/design-source/ui_kits/website/CarCard.jsx). Re-exports the two
-// cards, their helper parts and the view-model type so consumers can import
-// everything from '../cards'.
-
-export { default as CarCard } from './CarCard';
-export type { CarCardProps } from './CarCard';
-
-export { default as CarRow } from './CarRow';
-export type { CarRowProps } from './CarRow';
-
-export {
-  fmtKm,
-  cardSpec,
-  SpecLine,
-  PriceBlock,
-  DropChip,
-  EcoLine,
-  PricePaths,
-  PriceKauf,
-  PriceMeter,
-  PpActivity,
-} from './cardParts';
-export type {
-  SpecLineProps,
-  PriceBlockProps,
-  DropChipProps,
-  EcoLineProps,
-  PricePathsProps,
-  PpActivityProps,
-} from './cardParts';
-
-export type { AutobahnCar, AutobahnPhev } from './types';
+// Autobahn (auto.de redesign) — car cards barrel.
+//
+// ES named exports replacing the design kit's `Object.assign(window, {...})`
+// (docs/redesign/design-source/ui_kits/website/CarCard.jsx). Re-exports the two
+// cards, their helper parts and the view-model type so consumers can import
+// everything from '../cards'.
+
+export { default as CarCard } from './CarCard';
+export type { CarCardProps } from './CarCard';
+
+export { default as CarRow } from './CarRow';
+export type { CarRowProps } from './CarRow';
+
+export {
+  fmtKm,
+  cardSpec,
+  SpecLine,
+  PriceBlock,
+  DropChip,
+  EcoLine,
+  PricePaths,
+  PriceKauf,
+  PriceMeter,
+  PpActivity,
+  GalleryBadges,
+} from './cardParts';
+export type {
+  SpecLineProps,
+  PriceBlockProps,
+  DropChipProps,
+  EcoLineProps,
+  PricePathsProps,
+  PpActivityProps,
+  GalleryBadgesProps,
+} from './cardParts';
+
+export type { AutobahnCar, AutobahnPhev } from './types';

package/cards/types.ts

@@ -1,114 +1,124 @@
-// Autobahn (auto.de redesign) — car-card view-model type.
-//
-// Typed contract for the ported car cards (CarCard / CarRow). This is a pure
-// presentational view-model: the cards receive a fully-resolved `AutobahnCar`
-// and never touch the store, API or `window`.
-//
-// IMPORTANT — needs-data discipline:
-// The REQUIRED fields below always carry real data from the search/listing
-// source. The OPTIONAL fields are ones we have NO real source for yet; they are
-// `?`-optional ON PURPOSE so the components can detect their absence and render
-// the `NEEDS_DATA_LABEL` ('Daten folgt') marker instead of a fabricated number.
-// Never default these to placeholder values.
-
-/** Pkw-EnVKV plug-in-hybrid consumption block (only present for PHEV cars). */
-export interface AutobahnPhev {
-  /** electric consumption, e.g. '17,3 kWh/100 km'. */
-  consEl: string;
-  /** fuel consumption (weighted, combined), e.g. '1,2 l/100 km'. */
-  consFuel: string;
-  /** consumption when battery is discharged, e.g. '6,4 l/100 km'. */
-  consDis: string;
-  /** weighted combined CO₂, e.g. '28 g/km'. */
-  co2w: string;
-  /** CO₂ class (weighted). */
-  co2classW: string;
-  /** CO₂ class (discharged). */
-  co2classD: string;
-}
-
-/**
- * View-model for a single car as rendered by the Autobahn car cards.
- *
- * REQUIRED fields are always populated with real data.
- * OPTIONAL fields (`?`) have no real data source yet — when absent the cards
- * render the 'Daten folgt' marker rather than inventing a value.
- */
-export interface AutobahnCar {
-  // --- identity / headline (always real) ---
-  make: string;
-  model: string;
-  trim: string;
-
-  // --- key specs (always real) ---
-  /** mileage in km (raw number; formatted de-DE by the cards). */
-  km: number;
-  /** first registration, e.g. '03/2021'. */
-  reg: string;
-  /** power label, e.g. '110 kW (150 PS)'. */
-  power: string;
-  /** fuel label, e.g. 'Benzin' / 'Plug-in-Hybrid'. */
-  fuel: string;
-  /** gearbox label, e.g. 'Automatik' / 'Schaltgetriebe'. */
-  gear: string;
-  /** number of previous owners (rendered as 'N. Hand'). */
-  owners: number;
-
-  // --- price (always real) ---
-  /** financing monthly rate in EUR — the LEAD price on every card. */
-  monthly: number;
-  /** purchase price in EUR (raw number; formatted de-DE by the cards). */
-  price: number;
-
-  // --- media (always real) ---
-  /** ready-to-use image URLs for the carousel. */
-  gallery: string[];
-  /** total photo count for the image-count badge. */
-  photos: number;
-
-  // --- legally-required Pkw-EnVKV consumption line (always real) ---
-  /** combined fuel consumption label, e.g. '5,4 l/100 km'. */
-  cons: string;
-  /** combined CO₂ emissions label, e.g. '124 g/km'. */
-  co2: string;
-  /** CO₂ efficiency class letter, e.g. 'B'. */
-  co2class: string;
-  /** present only for plug-in hybrids — drives the dual-figure EnVKV line. */
-  phev?: AutobahnPhev;
-
-  // --- trust / features (always real) ---
-  /** equipment highlight chips (first few are shown on the row card). */
-  features: string[];
-  /** price rating tone: 'fair' → warn pill, anything else → good pill. */
-  rating: string;
-  /** price rating label shown in the pill, e.g. 'Guter Preis'. */
-  ratingLabel: string;
-  /** true → show the "NEU" badge (legacy showNewLabel: new / recently-listed car). */
-  isNew?: boolean;
-  /** availability label, e.g. 'Sofort verfügbar' (offer.availabilityMode). Absent → not shown. */
-  availability?: string;
-  /** percent price reduction (price.historyPriceDifferencePerCent) — pairs with `drop` for the −X% badge. */
-  dropPct?: number;
-  /** 0 € Anzahlung available (offer.showDownPayment) — drives the "0 € Anz." badge. */
-  zeroDown?: boolean;
-
-  // --- NEEDS DATA: no real source yet (NEVER fabricate) ---
-  /** original list price (for the struck-through reference price). */
-  listPrice?: number;
-  /** savings vs. list price in EUR (gates the savings/strike UI; >600 to show). */
-  savings?: number;
-  /** real price reduction on THIS car in EUR (gates the DropChip). */
-  drop?: number;
-  /** lowest comparable market price in EUR (market band lower bound). */
-  marketLow?: number;
-  /** average comparable market price in EUR (market band reference). */
-  marketAvg?: number;
-  /** highest comparable market price in EUR (market band upper bound). */
-  marketHigh?: number;
-  /** leasing monthly rate in EUR. */
-  lease?: number;
-  /** number of buyers currently watching this car. */
-  watchers?: number;
-  /** number of recent views (drives the 'vor N Std' cue). */
-  views?: number;
-}
+// Autobahn (auto.de redesign) — car-card view-model type.
+//
+// Typed contract for the ported car cards (CarCard / CarRow). This is a pure
+// presentational view-model: the cards receive a fully-resolved `AutobahnCar`
+// and never touch the store, API or `window`.
+//
+// IMPORTANT — needs-data discipline:
+// The REQUIRED fields below always carry real data from the search/listing
+// source. The OPTIONAL fields are ones we have NO real source for yet; they are
+// `?`-optional ON PURPOSE so the components can detect their absence and render
+// the `NEEDS_DATA_LABEL` ('Daten folgt') marker instead of a fabricated number.
+// Never default these to placeholder values.
+
+/** Pkw-EnVKV plug-in-hybrid consumption block (only present for PHEV cars). */
+export interface AutobahnPhev {
+  /** electric consumption, e.g. '17,3 kWh/100 km'. */
+  consEl: string;
+  /** fuel consumption (weighted, combined), e.g. '1,2 l/100 km'. */
+  consFuel: string;
+  /** consumption when battery is discharged, e.g. '6,4 l/100 km'. */
+  consDis: string;
+  /** weighted combined CO₂, e.g. '28 g/km'. */
+  co2w: string;
+  /** CO₂ class (weighted). */
+  co2classW: string;
+  /** CO₂ class (discharged). */
+  co2classD: string;
+}
+
+/**
+ * View-model for a single car as rendered by the Autobahn car cards.
+ *
+ * REQUIRED fields are always populated with real data.
+ * OPTIONAL fields (`?`) have no real data source yet — when absent the cards
+ * render the 'Daten folgt' marker rather than inventing a value.
+ */
+export interface AutobahnCar {
+  // --- identity / headline (always real) ---
+  make: string;
+  model: string;
+  trim: string;
+
+  // --- key specs (always real) ---
+  /** mileage in km (raw number; formatted de-DE by the cards). */
+  km: number;
+  /** first registration, e.g. '03/2021'. */
+  reg: string;
+  /** power label, e.g. '110 kW (150 PS)'. */
+  power: string;
+  /** fuel label, e.g. 'Benzin' / 'Plug-in-Hybrid'. */
+  fuel: string;
+  /** gearbox label, e.g. 'Automatik' / 'Schaltgetriebe'. */
+  gear: string;
+  /** number of previous owners (rendered as 'N. Hand'). */
+  owners: number;
+
+  // --- price (always real) ---
+  /** financing monthly rate in EUR — the LEAD price on every card. */
+  monthly: number;
+  /** purchase price in EUR (raw number; formatted de-DE by the cards). */
+  price: number;
+
+  // --- media (always real) ---
+  /** ready-to-use image URLs for the carousel. */
+  gallery: string[];
+  /** total photo count for the image-count badge. */
+  photos: number;
+
+  // --- legally-required Pkw-EnVKV consumption line (always real) ---
+  /** combined fuel consumption label, e.g. '5,4 l/100 km'. */
+  cons: string;
+  /** combined CO₂ emissions label, e.g. '124 g/km'. */
+  co2: string;
+  /** CO₂ efficiency class letter, e.g. 'B'. */
+  co2class: string;
+  /** present only for plug-in hybrids — drives the dual-figure EnVKV line. */
+  phev?: AutobahnPhev;
+
+  // --- trust / features (always real) ---
+  /** equipment highlight chips (first few are shown on the row card). */
+  features: string[];
+  /** price rating tone: 'fair' → warn pill, anything else → good pill. */
+  rating: string;
+  /** price rating label shown in the pill, e.g. 'Guter Preis'. */
+  ratingLabel: string;
+  /** true → show the "NEU" badge (legacy showNewLabel: new / recently-listed car). */
+  isNew?: boolean;
+  /** availability label, e.g. 'Sofort verfügbar' (offer.availabilityMode). Absent → not shown. */
+  availability?: string;
+  /** percent price reduction (price.historyPriceDifferencePerCent) — pairs with `drop` for the −X% badge. */
+  dropPct?: number;
+  /** 0 € Anzahlung available (offer.showDownPayment) — drives the "0 € Anz." badge. */
+  zeroDown?: boolean;
+
+  // --- NEEDS DATA: no real source yet (NEVER fabricate) ---
+  /** original list price (for the struck-through reference price). */
+  listPrice?: number;
+  /** savings vs. list price in EUR (gates the savings/strike UI; >600 to show). */
+  savings?: number;
+  /** real price reduction on THIS car in EUR (gates the DropChip). */
+  drop?: number;
+  /** lowest comparable market price in EUR (market band lower bound). */
+  marketLow?: number;
+  /** average comparable market price in EUR (market band reference). */
+  marketAvg?: number;
+  /** highest comparable market price in EUR (market band upper bound). */
+  marketHigh?: number;
+  /** leasing monthly rate in EUR. */
+  lease?: number;
+  /** number of buyers currently watching this car. */
+  watchers?: number;
+  /** number of recent views (drives the 'vor N Std' cue). */
+  views?: number;
+
+  // --- gallery activity strip (real data: UserActionsAPI 'stats/viewers', loaded async and
+  //     keyed by carId in SearchResultsStore.statsData — see fieldMapping.ts). Absent until that
+  //     fetch resolves. PM decision: the WHOLE badge row (availability/views/favorites/Geprüft)
+  //     is all-or-nothing — it renders only when BOTH counts are present and > 0; a missing or
+  //     zero count hides the entire row rather than showing a "0×" pill (GalleryBadges). ---
+  /** total detail-page views (stats totalCarImpCount) — shown as the eye pill under the image. */
+  viewsCount?: number;
+  /** total users who favorited this car (stats totalFavCount) — shown as the heart pill under the image. */
+  favoritesCount?: number;
+}