@autobusal/common 1.18.0 → 1.20.0

package/CHANGELOG.md

@@ -6,6 +6,24 @@ All notable changes to `@autobusal/common` are documented here. This project fol
 > Note: 1.10.0 through 1.15.1 were published without changelog entries. The
 > gap is left as-is rather than reconstructed after the fact.
 
+## 1.20.0
+
+`Rating` — stars, average and count, or nothing at all. Rendering nothing is
+the feature: obtapi withholds a score until there are enough published reviews
+to say something honest, so an absent rating has to read as "not saying yet"
+rather than as a zero. Anything filling the gap with empty stars would turn a
+new operator into a badly-rated one. Half stars are drawn, because rounding 3.5
+down loses the difference between middling and good — precisely the range where
+a reader is still deciding.
+
+## 1.19.0
+
+`extra` joins `create` and `search` as a top-of-table slot rather than a
+per-row action. Any table opting into the extra slot also rendered one empty,
+iconless, still-clickable button in every row's options cell — Icon has no
+case for `extra`, so it drew nothing while taking the click. The refund queue
+has been doing this all along; the new review queue would have too.
+
 ## [1.18.0] - 2026-08-02
 
 ### Added

package/Rating/Rating.tsx

@@ -0,0 +1,73 @@
+import { TFunction } from 'i18next';
+import { AiFillStar, AiOutlineStar } from 'react-icons/ai';
+import { BsStarHalf } from 'react-icons/bs';
+import { Container, Stars, Average, Count } from './styles';
+import { RatingData } from '@autobusal/providers/types/reviews';
+
+interface Props {
+  // an aggregate: stars, the average and how many reviews built it
+  rating?: RatingData | null
+  // Edited: Ferjolt Ozuni - Date: 2026-08-03
+  // ONE review's own rating: stars alone. Passing it through `rating` with a
+  // count of 1 drew "5.0 (1)" beside every single review and a tooltip
+  // reading "from 1 reviews" - a summary of a set of one, which is not what
+  // an individual review is.
+  value?: number
+  size?: 'small' | 'normal'
+  t: TFunction<'common'>
+}
+
+/**
+ * A published rating.
+ *
+ * Edited: Ferjolt Ozuni - Date: 2026-08-03
+ *
+ * Renders NOTHING when there is no rating, and that is the important part:
+ * obtapi withholds the score until a route or operator has enough published
+ * reviews to say something honest, so an absent rating must read as "we are
+ * not saying yet" rather than as a zero. Anything that filled the gap with
+ * empty stars or "0.0" would turn a new operator into a badly-rated one.
+ *
+ * The half star matters more than it looks. Rounding 3.5 down to three full
+ * stars loses the difference between a middling operator and a good one,
+ * which is precisely the range where a reader is still deciding.
+ */
+const Rating = ({ rating, value, size, t }: Props): (JSX.Element | null) => {
+  const average = value ?? rating?.average;
+
+  if (average === undefined || (value === undefined && !rating?.count)) {
+    return null;
+  }
+
+  const rounded = Math.round(average * 2) / 2;
+
+  const title = value !== undefined
+    ? t('rating.value', { average })
+    : t('rating.summary', { average, count: rating?.count });
+
+  return (
+    <Container $size={ size ?? 'normal' } title={ title }>
+      <Stars aria-hidden="true">
+        { [ 1, 2, 3, 4, 5 ].map(value => {
+          if (rounded >= value) {
+            return <AiFillStar key={ value } />;
+          }
+
+          return rounded >= value - 0.5
+            ? <BsStarHalf key={ value } />
+            : <AiOutlineStar key={ value } />;
+        }) }
+      </Stars>
+
+      { rating && (
+        <>
+          <Average>{ rating.average.toFixed(1) }</Average>
+
+          <Count>({ rating.count })</Count>
+        </>
+      ) }
+    </Container>
+  );
+};
+
+export default Rating;

package/Rating/styles.ts

@@ -0,0 +1,31 @@
+import styled, { css } from 'styled-components';
+
+export const Container = styled.span<{ $size: 'small' | 'normal' }>`
+  display: inline-flex;
+  align-items: center;
+  gap: 5px;
+  white-space: nowrap;
+  line-height: 1;
+
+  ${ props => props.$size === 'small' && css`
+    font-size: ${ props => props.theme.size.s };
+  ` }
+`;
+
+export const Stars = styled.span`
+  display: inline-flex;
+  gap: 1px;
+  color: ${ props => props.theme.primary.normal };
+
+  svg {
+    display: block;
+  }
+`;
+
+export const Average = styled.strong`
+  font-weight: 700;
+`;
+
+export const Count = styled.span`
+  color: ${ props => props.theme.font.faded };
+`;

package/Table/Actions/Get.tsx

@@ -14,7 +14,14 @@ interface Props {
 }
 
 const Get = ({ id, url, urlWith, type, t, handlers, navigate }: Props): (JSX.Element | null) => {
-  if (['create', 'search'].includes(type)) {
+  // Edited: Ferjolt Ozuni - Date: 2026-08-02
+  // 'extra' belongs with 'create' and 'search': all three are TOP-of-table
+  // slots, not per-row actions. Without it here, any table that opts into
+  // the extra slot (the refund queue does, the review queue now does too)
+  // also renders one empty, iconless, clickable button in every row's
+  // options cell - Icon has no case for 'extra', so it draws nothing at all
+  // while still taking the click.
+  if (['create', 'search', 'extra'].includes(type)) {
     return null;
   }
 

package/index.ts

@@ -25,6 +25,7 @@ import Pagination from './Pagination/Pagination';
 import Paragraph from './Loading/Paragraph';
 import Passengers from './Passengers/Passengers';
 import Password from './Password/Password';
+import Rating from './Rating/Rating';
 import Policy from './Policy/Policy';
 import Report from './Report/Report';
 import RouteFeature from './RouteFeature/RouteFeature';
@@ -73,6 +74,7 @@ export {
   Paragraph,
   Passengers,
   Password,
+  Rating,
   Policy,
   Report,
   RouteFeature,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@autobusal/common",
-  "version": "1.18.0",
+  "version": "1.20.0",
   "author": "Ferjolt Ozuni",
   "type": "module",
   "main": "index.ts"