@autobusal/common 1.19.0 → 1.21.0

package/CHANGELOG.md

@@ -6,6 +6,22 @@ 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.21.0
+
+`reply` joins the table actions with its own icon and label. The operator
+review page was borrowing `approve`, so the button on a review about them read
+"Approve" — which is the one thing they cannot do to it.
+
+## 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

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/Icon.tsx

@@ -4,7 +4,7 @@ import { BiEditAlt, BiTransfer, BiTrash } from 'react-icons/bi';
 import { FaTrash } from 'react-icons/fa';
 import { GiMoneyStack } from 'react-icons/gi';
 import { IoDocumentLockOutline } from 'react-icons/io5';
-import { RiBusLine, RiEyeLine, RiLoginCircleLine } from 'react-icons/ri';
+import { RiBusLine, RiEyeLine, RiLoginCircleLine, RiReplyLine } from 'react-icons/ri';
 
 interface Props {
   type: string
@@ -26,6 +26,14 @@ const Icon = ({ type, t }: Props): (JSX.Element | null) => {
     case 'approve':
       return <AiOutlineCheck title={ t('table.actions.custom.approve', { ns: 'common' }) } />;
 
+    // Edited: Ferjolt Ozuni - Date: 2026-08-03
+    // Its own action rather than borrowing 'approve'. On the operator's
+    // review page a tick labelled "Approve" reads as though they are
+    // approving the review about them, which is the one thing they cannot
+    // do - the verb has to be the one they are actually performing.
+    case 'reply':
+      return <RiReplyLine title={ t('table.actions.custom.reply', { ns: 'common' }) } />;
+
     case 'deny':
       return <FaTrash title={ t('table.actions.custom.deny', { ns: 'common' }) } />;
 

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.19.0",
+  "version": "1.21.0",
   "author": "Ferjolt Ozuni",
   "type": "module",
   "main": "index.ts"