@tribe-nest/forge 3.31.0 → 3.34.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tribe-nest/forge",
-  "version": "3.31.0",
+  "version": "3.34.0",
   "publishConfig": {
     "access": "public"
   },
@@ -10,12 +10,15 @@
     "./ui": "./src/ui/index.ts",
     "./ui/headless": "./src/ui/headless/index.ts",
     "./server": "./src/server/index.ts",
-    "./media": "./src/ui/media/index.ts"
+    "./media": "./src/ui/media/index.ts",
+    "./forge-utilities.css": "./src/ui/styled/forge-utilities.css"
   },
   "files": [
     "src"
   ],
   "scripts": {
+    "build:css": "tailwindcss -i tailwind.input.css -o src/ui/styled/forge-utilities.css && node scripts/wrapForgeCss.mjs",
+    "prepack": "npm run build:css",
     "check-types": "tsc --noEmit",
     "test": "vitest run",
     "test:watch": "vitest"
@@ -41,8 +44,10 @@
     "react-dom": ">=18"
   },
   "devDependencies": {
+    "@tailwindcss/cli": "4.1.11",
     "@types/react": "^19.1.2",
     "simple-icons": "^16.28.0",
+    "tailwindcss": "4.1.11",
     "typescript": "~5.8.3"
   },
   "license": "ISC"

package/src/contexts/CartContext.tsx

@@ -227,6 +227,23 @@ export function CartProvider({ children }: { children: ReactNode }) {
           i.recipientEmail === item.recipientEmail,
       );
 
+      /**
+       * The drawer opens on EVERY add, including one that turns out to be a
+       * duplicate.
+       *
+       * It used to open only for a line that was new. Pressing Add to cart on
+       * something already in the cart updated the line silently and left the
+       * page exactly as it was, which reads as a dead button: the shopper
+       * cannot tell the difference between "already there" and "the click did
+       * not register", so they press it again. Opening the drawer answers the
+       * question the press was asking, which is "is this in my cart".
+       *
+       * The RETURN value still distinguishes the two cases, so a consumer that
+       * wants to say "already in your cart" can still do it. Only the drawer
+       * stopped depending on which case it was.
+       */
+      setCartOpen(true);
+
       if (exists) {
         setCartItems((prev) =>
           prev.map((i) => {
@@ -247,7 +264,6 @@ export function CartProvider({ children }: { children: ReactNode }) {
         return false;
       }
       setCartItems((prev) => [...prev, next]);
-      setCartOpen(true);
       return true;
     },
     [cartItems],

package/src/contexts/_tests/CartContext.spec.tsx

@@ -147,6 +147,42 @@ describe("restoreCart: tickets", () => {
   });
 });
 
+describe("addToCart: the drawer", () => {
+  it("opens the drawer for a NEW line", () => {
+    const { result } = mount();
+
+    act(() => void result.current.addToCart(item()));
+
+    expect(result.current.isCartOpen).toBe(true);
+  });
+
+  it("opens the drawer again for a line ALREADY in the cart", () => {
+    /**
+     * The regression this exists for. Adding something already in the cart
+     * updated the line and left the page untouched, so the button read as
+     * dead: nothing on screen distinguished "already in your cart" from "that
+     * click did nothing", and the shopper pressed it again.
+     */
+    const { result } = mount();
+
+    act(() => void result.current.addToCart(item()));
+    act(() => result.current.setCartOpen(false));
+    expect(result.current.isCartOpen).toBe(false);
+
+    let wasNew: boolean | undefined;
+    act(() => {
+      wasNew = result.current.addToCart(item({ quantity: 2 }));
+    });
+
+    expect(result.current.isCartOpen).toBe(true);
+    // Still one line, still reporting the duplicate through the return value,
+    // so a consumer that wants to say "already in your cart" can.
+    expect(result.current.cartItems).toHaveLength(1);
+    expect(result.current.cartItems[0]).toMatchObject({ quantity: 2 });
+    expect(wasNew).toBe(false);
+  });
+});
+
 describe("restoreCart: products", () => {
   it("replaces a matching line rather than appending a duplicate of it", () => {
     const { result } = mount();

package/src/data/queries/useMyBookings.ts

@@ -93,6 +93,15 @@ export type MyBooking = {
   /** What became of the money: `refunded`, `voided_free`, `manual_refund_required`, … */
   cancellationOutcome: string | null;
   createdAt: string;
+  /**
+   * The call's address, or null when this session has no call.
+   *
+   * Present only for a CONFIRMED session on video, because that is when the
+   * room record is written. It is the id in `/video-calls/:callId`, opaque on
+   * purpose: it is not derived from the booking id, so a link in an email
+   * reveals nothing about the booking behind it.
+   */
+  videoCallId?: string | null;
   /** The slot the booking currently points at — what a reschedule moves. */
   coachingBookingSlotId: string;
   /**

package/src/i18n/_tests/translationKeys.spec.ts

@@ -150,4 +150,19 @@ describe("Forge i18n: every key a component uses exists in every bundle", () =>
     }
     expect(mismatches, `Interpolation drift:\n${mismatches.join("\n")}`).toEqual([]);
   });
+
+  it("no bundle value uses i18next's double braces, which Forge's interpolator does not read", () => {
+    // `translateForge` substitutes `{name}`. On `{{date}}` the regex matches
+    // the INNER braces, so the visitor saw "{Aug 20, 2026}" with a stray pair
+    // of braces around the value. Two keys shipped that way (copied from the
+    // admin bundle, which is i18next). The convention is single braces, and
+    // this pins it for every value in every bundle.
+    const offenders: string[] = [];
+    for (const [lang, bundle] of Object.entries(LOCALES)) {
+      for (const [key, value] of Object.entries(bundle)) {
+        if (value.includes("{{") || value.includes("}}")) offenders.push(`${lang}: ${key}`);
+      }
+    }
+    expect(offenders, `Double-brace placeholders:\n${offenders.join("\n")}`).toEqual([]);
+  });
 });

package/src/i18n/de.json

@@ -5,13 +5,16 @@
   "forge.account_dashboard.booking_duration": "{minutes} Minuten",
   "forge.account_dashboard.booking_join_label": "Teilnehmen:",
   "forge.account_dashboard.booking_video_call": "Videoanruf auf dieser Website",
+  "forge.account_dashboard.booking_join_video": "Videoanruf beitreten",
+  "forge.account_dashboard.booking_video_opens_at": "Videoanruf: Der Raum öffnet {datetime}",
+  "forge.account_dashboard.booking_video_closed": "Videoanruf: Der Raum dieser Session ist geschlossen",
   "forge.account_dashboard.booking_where_label": "Wo:",
   "forge.account_dashboard.cancel": "Abbrechen",
   "forge.account_dashboard.cancel_confirm_confirm": "Mitgliedschaft kündigen",
   "forge.account_dashboard.cancel_confirm_free": "Ihre Vorteile enden sofort.",
   "forge.account_dashboard.cancel_confirm_keep": "Mitgliedschaft behalten",
   "forge.account_dashboard.cancel_confirm_paid": "Sie wird nicht verlängert, und Ihre Vorteile bleiben bis zum Ende des bezahlten Zeitraums bestehen.",
-  "forge.account_dashboard.cancel_confirm_paid_until": "Sie wird nicht verlängert, und Ihre Vorteile bleiben bis zum {{date}} bestehen.",
+  "forge.account_dashboard.cancel_confirm_paid_until": "Sie wird nicht verlängert, und Ihre Vorteile bleiben bis zum {date} bestehen.",
   "forge.account_dashboard.cancel_confirm_title": "Mitgliedschaft kündigen?",
   "forge.account_dashboard.cancel_deletion": "Löschung abbrechen",
   "forge.account_dashboard.cancel_session": "Session stornieren",
@@ -184,6 +187,41 @@
   "forge.bundle_confirmation.tickets_emailed": "Tickets per E-Mail an dich unterwegs",
   "forge.bundle_confirmation.title": "Alles erledigt",
   "forge.bundle_confirmation.view_orders": "Bestellungen ansehen",
+  "forge.call_stage.status_ended": "Der Anruf ist beendet",
+  "forge.call_stage.status_connected": "Verbunden",
+  "forge.call_stage.status_connecting": "Verbindung zum Anruf wird hergestellt",
+  "forge.call_stage.status_left": "Du hast den Anruf verlassen",
+  "forge.call_stage.status_refused": "Beitritt zu diesem Anruf nicht möglich",
+  "forge.call_stage.status_moving": "Du wirst auf einen anderen Server verschoben",
+  "forge.call_stage.status_moving_detail": "Das dauert ein paar Sekunden, und niemand sonst wird getrennt.",
+  "forge.call_stage.status_move_failed": "Du konntest nicht auf einen anderen Server verschoben werden",
+  "forge.call_stage.status_move_failed_detail": "Niemand sonst wurde getrennt. Versuche es erneut, um wieder beizutreten.",
+  "forge.call_stage.status_reconnecting": "Verbindung unterbrochen, wird wiederhergestellt",
+  "forge.call_stage.status_reconnecting_detail": "Alle anderen sind weiterhin im Anruf.",
+  "forge.call_stage.status_lost": "Verbindung unterbrochen",
+  "forge.call_stage.status_lost_detail": "Alle anderen sind weiterhin im Anruf. Versuche es erneut, um wieder beizutreten.",
+  "forge.call_stage.retry": "Erneut versuchen",
+  "forge.call_stage.recording": "Dieser Anruf wird aufgezeichnet",
+  "forge.call_stage.head_count": "In diesem Anruf: {count}",
+  "forge.call_stage.help_hear_not_see_label": "Warum höre ich jemanden, sehe ihn aber nicht?",
+  "forge.call_stage.help_hear_not_see": "Eine Kachel mit Namen, aber ohne Bild bedeutet, dass diese Person ihre Kamera ausgeschaltet hat oder dass der Anruf so voll ist, dass nur die gerade sprechenden Personen in voller Größe übertragen werden. Beides ist normal, und der Ton ist davon nicht betroffen.",
+  "forge.call_stage.listening": "(hört zu)",
+  "forge.call_stage.you": "Du",
+  "forge.call_stage.you_not_connected": "Du (noch nicht verbunden)",
+  "forge.call_stage.mute": "Stummschalten",
+  "forge.call_stage.unmute": "Stummschaltung aufheben",
+  "forge.call_stage.camera_start": "Kamera starten",
+  "forge.call_stage.camera_stop": "Kamera stoppen",
+  "forge.call_stage.help_camera_stop_label": "Was macht „Kamera stoppen“?",
+  "forge.call_stage.help_camera_stop": "Dein Bild wird nicht mehr gesendet: Die anderen sehen stattdessen deinen Namen. Der Browser hält die Kamera geöffnet, damit das erneute Starten sofort geht und nicht ein zweites Mal um Erlaubnis fragt. Deshalb kann die Kameraleuchte anbleiben, bis du den Anruf verlässt.",
+  "forge.call_stage.screen_start": "Bildschirm teilen",
+  "forge.call_stage.screen_stop": "Teilen beenden",
+  "forge.call_stage.help_screen_label": "Was wird beim Teilen meines Bildschirms gesendet?",
+  "forge.call_stage.help_screen": "Was auch immer du im Browser-Dialog auswählst, live an alle im Anruf. Deine Kamera läuft dabei weiter, statt ersetzt zu werden, sodass dich die anderen weiterhin sehen können, während du präsentierst.",
+  "forge.call_stage.leave": "Verlassen",
+  "forge.call_stage.lost_microphone": "Dein Mikrofon wurde ausgeschaltet, als die Verbindung abbrach. Hebe die Stummschaltung auf, um wieder gehört zu werden.",
+  "forge.call_stage.lost_camera": "Deine Kamera wurde ausgeschaltet, als die Verbindung abbrach. Starte sie erneut, um wieder gesehen zu werden.",
+  "forge.call_stage.lost_screen": "Deine Bildschirmfreigabe wurde beendet, als die Verbindung abbrach. Teile ihn erneut, um fortzufahren.",
   "forge.cancellation_terms.title": "Stornobedingungen",
   "forge.cart.aria_close": "Warenkorb schließen",
   "forge.cart.aria_open": "Warenkorb öffnen",
@@ -790,7 +828,7 @@
   "forge.membership_checkout.payment_title": "Zahlung",
   "forge.membership_checkout.per_month": "pro Monat",
   "forge.membership_checkout.per_year": "pro Jahr",
-  "forge.membership_checkout.pwyw_charged_as": "Ihnen werden {{amount}} berechnet.",
+  "forge.membership_checkout.pwyw_charged_as": "Ihnen werden {amount} berechnet.",
   "forge.membership_checkout.pwyw_label": "Wie viel möchtest du zahlen?",
   "forge.membership_checkout.pwyw_min": "(mindestens {amount})",
   "forge.membership_checkout.select_tier": "Diesen Tarif wählen",

package/src/i18n/en.json

@@ -5,13 +5,16 @@
   "forge.account_dashboard.booking_duration": "{minutes} minutes",
   "forge.account_dashboard.booking_join_label": "Join:",
   "forge.account_dashboard.booking_video_call": "Video call on this site",
+  "forge.account_dashboard.booking_join_video": "Join video call",
+  "forge.account_dashboard.booking_video_opens_at": "Video call: the room opens {datetime}",
+  "forge.account_dashboard.booking_video_closed": "Video call: this session's room has closed",
   "forge.account_dashboard.booking_where_label": "Where:",
   "forge.account_dashboard.cancel": "Cancel",
   "forge.account_dashboard.cancel_confirm_confirm": "Cancel membership",
   "forge.account_dashboard.cancel_confirm_free": "Your benefits will stop right away.",
   "forge.account_dashboard.cancel_confirm_keep": "Keep membership",
   "forge.account_dashboard.cancel_confirm_paid": "It will not renew, and you keep your benefits until the end of the period you have paid for.",
-  "forge.account_dashboard.cancel_confirm_paid_until": "It will not renew, and you keep your benefits until {{date}}.",
+  "forge.account_dashboard.cancel_confirm_paid_until": "It will not renew, and you keep your benefits until {date}.",
   "forge.account_dashboard.cancel_confirm_title": "Cancel your membership?",
   "forge.account_dashboard.cancel_deletion": "Cancel Deletion",
   "forge.account_dashboard.cancel_session": "Cancel session",
@@ -184,6 +187,41 @@
   "forge.bundle_confirmation.tickets_emailed": "Tickets emailed to you",
   "forge.bundle_confirmation.title": "You're all set",
   "forge.bundle_confirmation.view_orders": "View your orders",
+  "forge.call_stage.status_ended": "The call has ended",
+  "forge.call_stage.status_connected": "Connected",
+  "forge.call_stage.status_connecting": "Connecting to the call",
+  "forge.call_stage.status_left": "You have left the call",
+  "forge.call_stage.status_refused": "Could not join this call",
+  "forge.call_stage.status_moving": "Moving you to another server",
+  "forge.call_stage.status_moving_detail": "This takes a few seconds and nobody else is dropped.",
+  "forge.call_stage.status_move_failed": "Could not move you to another server",
+  "forge.call_stage.status_move_failed_detail": "Nobody else was dropped. Try again to rejoin.",
+  "forge.call_stage.status_reconnecting": "Connection lost, reconnecting",
+  "forge.call_stage.status_reconnecting_detail": "Everyone else is still in the call.",
+  "forge.call_stage.status_lost": "Connection lost",
+  "forge.call_stage.status_lost_detail": "Everyone else is still in the call. Try again to rejoin.",
+  "forge.call_stage.retry": "Try again",
+  "forge.call_stage.recording": "This call is being recorded",
+  "forge.call_stage.head_count": "In this call: {count}",
+  "forge.call_stage.help_hear_not_see_label": "Why can I hear someone but not see them?",
+  "forge.call_stage.help_hear_not_see": "A tile with a name and no picture means that person has their camera off, or the call is busy enough that only the people currently speaking are sent in full. Both are normal, and their audio is unaffected.",
+  "forge.call_stage.listening": "(listening)",
+  "forge.call_stage.you": "You",
+  "forge.call_stage.you_not_connected": "You (not connected yet)",
+  "forge.call_stage.mute": "Mute",
+  "forge.call_stage.unmute": "Unmute",
+  "forge.call_stage.camera_start": "Start camera",
+  "forge.call_stage.camera_stop": "Stop camera",
+  "forge.call_stage.help_camera_stop_label": "What does Stop camera do?",
+  "forge.call_stage.help_camera_stop": "It stops sending your picture: the others see your name instead. The browser keeps the camera open so that starting it again is instant and does not ask for permission a second time, which means its indicator light can stay on until you leave the call.",
+  "forge.call_stage.screen_start": "Share screen",
+  "forge.call_stage.screen_stop": "Stop sharing",
+  "forge.call_stage.help_screen_label": "What does sharing my screen send?",
+  "forge.call_stage.help_screen": "Whatever you pick in the browser prompt, live, to everyone in the call. Your camera keeps running alongside it rather than being replaced, so people can still see you while you present.",
+  "forge.call_stage.leave": "Leave",
+  "forge.call_stage.lost_microphone": "Your microphone was turned off when the connection dropped. Unmute to be heard again.",
+  "forge.call_stage.lost_camera": "Your camera was turned off when the connection dropped. Start it again to be seen.",
+  "forge.call_stage.lost_screen": "Your screen share ended when the connection dropped. Share it again to continue.",
   "forge.cancellation_terms.title": "Cancellation policy",
   "forge.cart.aria_close": "Close cart",
   "forge.cart.aria_open": "Open cart",
@@ -790,7 +828,7 @@
   "forge.membership_checkout.payment_title": "Payment",
   "forge.membership_checkout.per_month": "per month",
   "forge.membership_checkout.per_year": "per year",
-  "forge.membership_checkout.pwyw_charged_as": "You will be charged {{amount}}.",
+  "forge.membership_checkout.pwyw_charged_as": "You will be charged {amount}.",
   "forge.membership_checkout.pwyw_label": "How much would you like to pay?",
   "forge.membership_checkout.pwyw_min": "(minimum {amount})",
   "forge.membership_checkout.select_tier": "Select this tier",

package/src/ui/index.ts

@@ -1,5 +1,30 @@
 // Forge UI — Tier-2 styled blocks (theme-aware, opinionated) + the theme
 // contract. Built on the Tier-1 headless primitives in `forge/ui/headless`.
+
+// Compiled Tailwind utilities for every className in Forge's source, generated
+// by `npm run build:css` (see tailwind.input.css for why the consumer site's
+// own Tailwind scan cannot be relied on). Bundlers deliver a side-effect CSS
+// import from a library the same way the rich-text.css imports already ship.
+// Compiled Tailwind utilities for every className in Forge's source, generated
+// by `npm run build:css` (see tailwind.input.css for why the consumer site's
+// own Tailwind scan cannot be relied on). Bundlers deliver a side-effect CSS
+// import from a library the same way the rich-text.css imports already ship.
+//
+// This import MUST stay a side effect, and the reason is not stylistic. A site
+// deployed before this shipped has a `styles.css` we never rewrite: Update
+// Theme repins Forge's version and touches nothing else. So an explicit
+// `@import` in the starter reaches NEW sites only, and every existing site
+// would silently lose its Forge layouts the moment it repinned. Delivering
+// from the package is the only route that reaches a site nobody edits.
+//
+// The cost is that it reaches every consumer, including our own apps, and the
+// file is not shy: `@layer theme` redefines 23 root design tokens and
+// `@layer properties` resets 43 `--tw-*` on the universal selector. That made
+// the admin dashboard sidebar disappear (2026-08-22). Admin therefore aliases
+// this file to an empty stub in its vite config and `@source`s Forge's source
+// instead. A monorepo app that renders Forge components should do the same.
+import "./styled/forge-utilities.css";
+
 export {
   ForgeThemeProvider,
   useForgeTheme,

package/src/ui/media/BookingCallScreen.tsx

@@ -0,0 +1,33 @@
+import type { ReactNode } from "react";
+
+import { CallStage } from "./CallStage";
+import { BookingCallProvider } from "./bookingSession";
+
+export type BookingCallScreenProps = {
+  bookingId: string;
+  /** Shown as the call's title: the product the session was bought on. */
+  title: string;
+  /** Leave. The caller unmounts this subtree, which is what ends the call. */
+  onLeave: () => void;
+};
+
+/**
+ * One booking's call: the provider wired to the credential endpoint, and the
+ * one call UI inside it.
+ *
+ * A DEFAULT export on purpose. `AccountDashboard` (in the `./ui` entry every
+ * site loads) reaches this through `React.lazy(() => import(...))`, so the
+ * media SDK and mediasoup are fetched by the browser only when somebody
+ * actually presses Join, rather than by every visitor to every account page.
+ * The provider connects on mount and closes on unmount, so the caller's
+ * "joined" state is exactly the call's lifetime: leaving goes through state,
+ * never through a `close()` that leaves a live provider mounted to reconnect
+ * on its next render.
+ */
+export default function BookingCallScreen({ bookingId, title, onLeave }: BookingCallScreenProps): ReactNode {
+  return (
+    <BookingCallProvider bookingId={bookingId}>
+      <CallStage title={title} onLeave={onLeave} />
+    </BookingCallProvider>
+  );
+}