summit-registration-lite 7.0.0 → 7.0.1

package/.claude/rules/summit-registration-lite-i18n.md

@@ -0,0 +1,62 @@
+# i18n / Translation Pattern
+
+## When to Apply
+
+Adding user-facing text to components or modifying existing strings.
+
+## Pattern
+
+**Library:** `i18n-react` — imported as `T`.
+
+**Setup (in `registration-lite.js`):**
+
+```javascript
+import T from 'i18n-react';
+
+// Loaded once at component init, falls back to English
+try {
+    T.setTexts(require(`../i18n/${language}.json`));
+} catch {
+    T.setTexts(require(`../i18n/en.json`));
+}
+```
+
+**Usage in components:**
+
+```javascript
+import T from 'i18n-react';
+
+// Simple key
+T.translate("bar_button.next")  // → "Next"
+
+// With interpolation
+T.translate("purchase_complete_step.footer_assistance_text", { supportEmail: "help@example.com" })
+// Template: "For further assistance, please email <a href=\"mailto:{supportEmail}\">{supportEmail}</a>"
+```
+
+## Translation File Structure
+
+`src/i18n/en.json` — flat namespaced by UI section:
+
+```json
+{
+  "purchase_complete_step": { "title": "...", "initial_order_complete_button": "..." },
+  "ticket_type": { "ticket_quantity_tooltip": "..." },
+  "promo_code": { "promo_code_tooltip": "..." },
+  "bar_button": { "back": "Back", "next": "Next", "get_ticket": "Get Ticket", "pay_now": "Pay Now", "loading": "Loading" }
+}
+```
+
+## Key Points
+
+- Namespace keys by component/step: `"section_name.key_name"`
+- Interpolation uses `{variableName}` syntax (not `${}` or `%s`)
+- HTML is allowed in translation values (rendered as-is)
+- Only English (`en.json`) exists — add new languages as `{lang}.json` in `src/i18n/`
+- Components using text must `import T from 'i18n-react'`
+
+## Common Mistakes
+
+- Hardcoding user-facing strings instead of using `T.translate()`
+- Adding keys without updating `en.json` (renders the key path as literal text)
+- Using wrong namespace (check `en.json` for existing sections before creating new ones)

package/.claude/rules/summit-registration-lite-step-flow.md

@@ -0,0 +1,77 @@
+# Multi-Step Registration Flow
+
+## When to Apply
+
+Adding step-specific logic, modifying step transitions, or rendering step-dependent UI.
+
+## Step Constants
+
+Defined in `src/utils/constants.js`:
+
+```javascript
+export const STEP_SELECT_TICKET_TYPE = 0;  // Ticket selection + promo code
+export const STEP_PERSONAL_INFO = 1;       // Attendee details + ticket assignment
+export const STEP_PAYMENT = 2;             // Payment form (Stripe/LawPay)
+export const STEP_COMPLETE = 3;            // Order confirmation
+```
+
+## Step Transitions
+
+**Forward flow (happy path):**
+
+```
+STEP_SELECT_TICKET_TYPE → (Next/validate promo) → STEP_PERSONAL_INFO
+STEP_PERSONAL_INFO → (submit form) → reserveTicket → STEP_PAYMENT
+STEP_PAYMENT → (pay) → payTicketWithProvider → STEP_COMPLETE
+```
+
+**Special cases:**
+
+| Scenario | Transition |
+|----------|------------|
+| Free ticket (cost === 0) | `STEP_PERSONAL_INFO` → skip payment → `STEP_COMPLETE` |
+| Pre-paid ticket | `STEP_PERSONAL_INFO` → skip payment → `STEP_COMPLETE` |
+| Payment failure | `STEP_PAYMENT` → `removeReservedTicket()` → `STEP_PERSONAL_INFO` |
+| No ticket selected + back | Any step → `STEP_SELECT_TICKET_TYPE` |
+
+**Back navigation:**
+
+- From `STEP_PERSONAL_INFO`: `changeStep(step - 1)`
+- From `STEP_PAYMENT`: `removeReservedTicket()` (clears reservation, reducer resets to `STEP_PERSONAL_INFO`)
+
+## Redux Integration
+
+```javascript
+// Action
+export const changeStep = (step) => (dispatch, getState) => {
+    dispatch(createAction(CHANGE_STEP)(step));
+};
+
+// Reducer
+case CHANGE_STEP: {
+    return { ...state, step: payload };
+}
+```
+
+Default state: `step: STEP_SELECT_TICKET_TYPE`
+
+## Rendering Pattern
+
+In `registration-lite.js`, each step renders conditionally:
+
+```javascript
+<StepComponent isActive={step === STEP_SELECT_TICKET_TYPE} ... />
+<StepComponent isActive={step === STEP_PERSONAL_INFO} ... />
+<StepComponent isActive={step === STEP_PAYMENT} ... />
+{step === STEP_COMPLETE && <PurchaseCompleteComponent ... />}
+```
+
+- Steps 0-2 share layout with `ButtonBarComponent`
+- Step 3 (complete) has its own layout, no button bar
+- Button bar renders step-specific buttons based on current `step` value
+
+## Common Mistakes
+
+- Skipping `removeReservedTicket()` when going back from payment (leaves stale reservation)
+- Not checking `reservation` existence before allowing forward navigation
+- Adding steps without updating `ButtonBarComponent` (buttons won't render for new step)

package/.claude/rules/summit-registration-lite-utils.md

@@ -0,0 +1,71 @@
+# Utility Functions
+
+## When to Apply
+
+Working with ticket pricing, order status checks, payment provider resolution, or UI color logic.
+
+## Key Functions (`src/utils/utils.js`)
+
+### Order/Ticket Status Checks
+
+```javascript
+isFreeOrder(reservation)        // reservation.amount === 0
+isPrePaidOrder(reservation)     // status === 'Paid' && payment_method === 'Offline'
+isPrePaidTicketType(ticketType) // ticketType.sub_type === 'PrePaid'
+hasDiscountApplied(ticketType)  // has cost_with_applied_discount !== cost
+```
+
+Used in payment providers to decide whether to skip the payment gateway.
+
+### Pricing Display
+
+```javascript
+getTicketCost(ticket, quantity)  // Returns JSX: strikethrough original + discounted price, or just price
+getTicketTaxes(ticket, taxes)    // Returns tax label string: " plus Tax A & Tax B"
+formatCurrency(amount, { currency })  // From helpers/ — locale-aware currency formatting
+```
+
+### Payment Provider Resolution
+
+```javascript
+getCurrentProvider(summit)
+// Iterates summit.payment_profiles for application_type === 'Registration'
+// Returns { publicKey, provider } — uses test vs live key based on test_mode_enabled
+```
+
+### UI Helpers
+
+```javascript
+getContrastingTextColor(bgColor, lightColor, darkColor)  // WCAG luminance contrast
+parseColor(input, element)       // Resolves CSS variables to RGB
+removeWhiteSpaces(value)         // Strip all whitespace
+isEmptyString(val)               // Trim-aware empty check
+```
+
+### Error Tracking
+
+```javascript
+handleSentryException(err)       // Sends to Sentry if window.SENTRY_DSN is set, else console.log
+```
+
+### Analytics
+
+```javascript
+buildTrackEvent(data, ticketQuantity, promoCode)
+// Builds GA4-style event data with currency, items_array, discount
+```
+
+## Helper Exports (`src/helpers/`)
+
+Barrel export from `src/helpers/index.js`:
+
+- `capitalizeFirstLetter` — text formatting
+- `formatCurrency` — locale-aware currency display
+- `formatErrorMessage` — error message normalization
+- `getTicketMaxQuantity` — ticket quantity constraints
+
+## Common Mistakes
+
+- Using `reservation.amount === 0` directly instead of `isFreeOrder()` (misses edge cases)
+- Forgetting `isPrePaidOrder()` check alongside `isFreeOrder()` in payment flows
+- Not handling `getCurrentProvider()` returning `{ publicKey: null, provider: '' }` when no payment profile exists

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "summit-registration-lite",
-  "version": "7.0.0",
+  "version": "7.0.1",
   "description": "Summit Registration Lite",
   "main": "index.js",
   "scripts": {