@modernman00/shared-js-lib 1.2.90 → 1.6.2

package/AddressAutocomplete.js

@@ -8,6 +8,84 @@
 const UK_POSTCODE_REGEX = /^[A-Z]{1,2}[0-9][A-Z0-9]?(\s*[0-9][A-Z]{2})?$/i;
 const UK_FULL_POSTCODE_REGEX = /^[A-Z]{1,2}[0-9][A-Z0-9]?\s*[0-9][A-Z]{2}$/i;
 
+// ⚡ High-speed internal address, venue and postal district index (< 1ms instant matching)
+export const INTERNAL_VENUE_INDEX = [
+  // Iconic Event & Celebration Venues / Hotels
+  { title: "Hilton London Park Lane", subtitle: "22 Park Lane, Mayfair, London W1K 1BE", fullAddress: "Hilton London Park Lane, 22 Park Lane, Mayfair, London, W1K 1BE, UK", icon: "🏛️" },
+  { title: "Hilton London Metropole", subtitle: "225 Edgware Rd, Paddington, London W2 1JU", fullAddress: "Hilton London Metropole, 225 Edgware Rd, London, W2 1JU, UK", icon: "🏛️" },
+  { title: "Hilton Manchester Deansgate", subtitle: "303 Deansgate, Manchester M3 4LQ", fullAddress: "Hilton Manchester Deansgate, 303 Deansgate, Manchester, M3 4LQ, UK", icon: "🏛️" },
+  { title: "Hilton Birmingham Metropole", subtitle: "NEC, Pendigo Way, Birmingham B40 1PP", fullAddress: "Hilton Birmingham Metropole, Pendigo Way, Birmingham, B40 1PP, UK", icon: "🏛️" },
+  { title: "The Savoy London", subtitle: "Strand, Covent Garden, London WC2R 0EZ", fullAddress: "The Savoy, Strand, London, WC2R 0EZ, UK", icon: "✨" },
+  { title: "The Dorchester", subtitle: "53 Park Lane, Mayfair, London W1K 1QA", fullAddress: "The Dorchester, 53 Park Lane, Mayfair, London, W1K 1QA, UK", icon: "✨" },
+  { title: "The Ritz London", subtitle: "150 Piccadilly, St. James's, London W1J 9BR", fullAddress: "The Ritz London, 150 Piccadilly, London, W1J 9BR, UK", icon: "✨" },
+  { title: "Claridge's", subtitle: "Brook Street, Mayfair, London W1K 4HR", fullAddress: "Claridge's, Brook Street, Mayfair, London, W1K 4HR, UK", icon: "✨" },
+  { title: "Shangri-La The Shard", subtitle: "31 St Thomas St, London Bridge, London SE1 9QU", fullAddress: "Shangri-La The Shard, 31 St Thomas St, London, SE1 9QU, UK", icon: "🏛️" },
+  { title: "Park Plaza Westminster Bridge", subtitle: "200 Westminster Bridge Rd, London SE1 7UT", fullAddress: "Park Plaza Westminster Bridge, 200 Westminster Bridge Rd, London, SE1 7UT, UK", icon: "🏛️" },
+  { title: "London Marriott Hotel Grosvenor Square", subtitle: "Grosvenor Square, Mayfair, London W1K 6JP", fullAddress: "London Marriott Hotel Grosvenor Square, London, W1K 6JP, UK", icon: "🏛️" },
+  { title: "London Marriott Hotel Marble Arch", subtitle: "134 George St, London W1H 5DN", fullAddress: "London Marriott Hotel Marble Arch, 134 George St, London, W1H 5DN, UK", icon: "🏛️" },
+  { title: "Kimpton Fitzroy London", subtitle: "1-8 Russell Square, Bloomsbury, London WC1B 5BE", fullAddress: "Kimpton Fitzroy London, 1-8 Russell Square, London, WC1B 5BE, UK", icon: "🏛️" },
+  { title: "St. Pancras Renaissance Hotel", subtitle: "Euston Rd, King's Cross, London NW1 2AR", fullAddress: "St. Pancras Renaissance Hotel, Euston Rd, London, NW1 2AR, UK", icon: "🏛️" },
+  { title: "JW Marriott Grosvenor House", subtitle: "86-90 Park Ln, Mayfair, London W1K 7TN", fullAddress: "JW Marriott Grosvenor House, 86-90 Park Ln, London, W1K 7TN, UK", icon: "🏛️" },
+  { title: "The Ned London", subtitle: "27 Poultry, City of London EC2R 8AJ", fullAddress: "The Ned, 27 Poultry, London, EC2R 8AJ, UK", icon: "🏛️" },
+  { title: "Natural History Museum", subtitle: "Cromwell Rd, South Kensington, London SW7 5BD", fullAddress: "Natural History Museum, Cromwell Rd, South Kensington, London, SW7 5BD, UK", icon: "🏛️" },
+  { title: "Victoria and Albert Museum", subtitle: "Cromwell Rd, South Kensington, London SW7 2RL", fullAddress: "Victoria and Albert Museum, Cromwell Rd, London, SW7 2RL, UK", icon: "🏛️" },
+  { title: "Alexandra Palace", subtitle: "Alexandra Palace Way, London N22 7AY", fullAddress: "Alexandra Palace, Alexandra Palace Way, London, N22 7AY, UK", icon: "🏛️" },
+  { title: "Royal Horticultural Halls (Lindley Hall)", subtitle: "Elverton St, Westminster, London SW1P 2PB", fullAddress: "Lindley Hall, Royal Horticultural Halls, Elverton St, London, SW1P 2PB, UK", icon: "🏛️" },
+  { title: "The Brewery London", subtitle: "52 Chiswell St, London EC1Y 4SD", fullAddress: "The Brewery, 52 Chiswell St, London, EC1Y 4SD, UK", icon: "🏛️" },
+  { title: "One Marylebone", subtitle: "1 Marylebone Rd, London NW1 4AQ", fullAddress: "One Marylebone, 1 Marylebone Rd, London, NW1 4AQ, UK", icon: "🏛️" },
+  { title: "8 Northumberland Avenue", subtitle: "Northumberland Ave, Trafalgar Square, London WC2N 5BY", fullAddress: "8 Northumberland Avenue, London, WC2N 5BY, UK", icon: "🏛️" },
+  { title: "Tobacco Dock", subtitle: "Tobacco Quay, Wapping Lane, London E1W 2SF", fullAddress: "Tobacco Dock, Wapping Lane, London, E1W 2SF, UK", icon: "🏛️" },
+  { title: "Blenheim Palace", subtitle: "Woodstock, Oxfordshire OX20 1PS", fullAddress: "Blenheim Palace, Woodstock, Oxfordshire, OX20 1PS, UK", icon: "🏛️" },
+  { title: "Celtic Manor Resort", subtitle: "Coldra Woods, Newport NP18 1HQ", fullAddress: "Celtic Manor Resort, Coldra Woods, Newport, NP18 1HQ, UK", icon: "🏛️" },
+  { title: "The Balmoral Hotel", subtitle: "1 Princes St, Edinburgh EH2 2EQ", fullAddress: "The Balmoral Hotel, 1 Princes St, Edinburgh, EH2 2EQ, UK", icon: "🏛️" },
+  { title: "The Grand Hotel Birmingham", subtitle: "Colmore Row, Birmingham B3 2BS", fullAddress: "The Grand Hotel Birmingham, Colmore Row, Birmingham, B3 2BS, UK", icon: "🏛️" },
+  { title: "Midland Hotel Manchester", subtitle: "16 Peter St, Manchester M60 2DS", fullAddress: "Midland Hotel, 16 Peter St, Manchester, M60 2DS, UK", icon: "🏛️" },
+  { title: "Radisson Blu Hotel Manchester Airport", subtitle: "Chicago Ave, Manchester M90 3RA", fullAddress: "Radisson Blu Hotel, Manchester Airport, M90 3RA, UK", icon: "🏛️" },
+  { title: "Kew Gardens (Temperate House)", subtitle: "Kew, Richmond, London TW9 3AE", fullAddress: "Kew Gardens, Kew, Richmond, TW9 3AE, UK", icon: "🌿" },
+
+  // Major UK Cities & Towns
+  { title: "London", subtitle: "Greater London, United Kingdom", fullAddress: "London, Greater London, United Kingdom", icon: "📍" },
+  { title: "Manchester", subtitle: "Greater Manchester, North West England, UK", fullAddress: "Manchester, Greater Manchester, United Kingdom", icon: "📍" },
+  { title: "Birmingham", subtitle: "West Midlands, United Kingdom", fullAddress: "Birmingham, West Midlands, United Kingdom", icon: "📍" },
+  { title: "Leeds", subtitle: "West Yorkshire, United Kingdom", fullAddress: "Leeds, West Yorkshire, United Kingdom", icon: "📍" },
+  { title: "Glasgow", subtitle: "Scotland, United Kingdom", fullAddress: "Glasgow, Scotland, United Kingdom", icon: "📍" },
+  { title: "Edinburgh", subtitle: "City of Edinburgh, Scotland, UK", fullAddress: "Edinburgh, City of Edinburgh, Scotland, UK", icon: "📍" },
+  { title: "Liverpool", subtitle: "Merseyside, North West England, UK", fullAddress: "Liverpool, Merseyside, United Kingdom", icon: "📍" },
+  { title: "Bristol", subtitle: "South West England, United Kingdom", fullAddress: "Bristol, South West England, United Kingdom", icon: "📍" },
+  { title: "Newcastle upon Tyne", subtitle: "Tyne and Wear, North East England, UK", fullAddress: "Newcastle upon Tyne, Tyne and Wear, United Kingdom", icon: "📍" },
+  { title: "Sheffield", subtitle: "South Yorkshire, United Kingdom", fullAddress: "Sheffield, South Yorkshire, United Kingdom", icon: "📍" },
+  { title: "Cardiff", subtitle: "Wales, United Kingdom", fullAddress: "Cardiff, Wales, United Kingdom", icon: "📍" },
+  { title: "Belfast", subtitle: "Northern Ireland, United Kingdom", fullAddress: "Belfast, Northern Ireland, United Kingdom", icon: "📍" },
+  { title: "Nottingham", subtitle: "Nottinghamshire, East Midlands, UK", fullAddress: "Nottingham, Nottinghamshire, United Kingdom", icon: "📍" },
+  { title: "Southampton", subtitle: "Hampshire, South East England, UK", fullAddress: "Southampton, Hampshire, United Kingdom", icon: "📍" },
+  { title: "Brighton and Hove", subtitle: "East Sussex, South East England, UK", fullAddress: "Brighton and Hove, East Sussex, United Kingdom", icon: "📍" },
+  { title: "Leicester", subtitle: "Leicestershire, East Midlands, UK", fullAddress: "Leicester, Leicestershire, United Kingdom", icon: "📍" },
+  { title: "Coventry", subtitle: "West Midlands, United Kingdom", fullAddress: "Coventry, West Midlands, United Kingdom", icon: "📍" },
+  { title: "Oxford", subtitle: "Oxfordshire, South East England, UK", fullAddress: "Oxford, Oxfordshire, United Kingdom", icon: "📍" },
+  { title: "Cambridge", subtitle: "Cambridgeshire, East of England, UK", fullAddress: "Cambridge, Cambridgeshire, United Kingdom", icon: "📍" },
+  { title: "York", subtitle: "North Yorkshire, United Kingdom", fullAddress: "York, North Yorkshire, United Kingdom", icon: "📍" },
+  { title: "Bath", subtitle: "Somerset, South West England, UK", fullAddress: "Bath, Somerset, United Kingdom", icon: "📍" },
+  { title: "Aberdeen", subtitle: "Scotland, United Kingdom", fullAddress: "Aberdeen, Scotland, United Kingdom", icon: "📍" },
+  { title: "Milton Keynes", subtitle: "Buckinghamshire, South East England, UK", fullAddress: "Milton Keynes, Buckinghamshire, United Kingdom", icon: "📍" },
+  { title: "Reading", subtitle: "Berkshire, South East England, UK", fullAddress: "Reading, Berkshire, United Kingdom", icon: "📍" },
+
+  // Key Postcode Areas & Landmark Postal Sectors
+  { title: "SW1A 1AA", subtitle: "Buckingham Palace, City of Westminster, London", fullAddress: "Buckingham Palace, London, SW1A 1AA, UK", icon: "📮" },
+  { title: "SW1", subtitle: "Westminster, Victoria, Belgravia, London", fullAddress: "SW1, City of Westminster, London, UK", icon: "📮" },
+  { title: "W1", subtitle: "Mayfair, Marylebone, Soho, Fitzrovia, London", fullAddress: "W1, West End, London, UK", icon: "📮" },
+  { title: "WC2", subtitle: "Covent Garden, Holborn, Strand, London", fullAddress: "WC2, London, UK", icon: "📮" },
+  { title: "EC1", subtitle: "Clerkenwell, Farringdon, Finsbury, London", fullAddress: "EC1, Central London, UK", icon: "📮" },
+  { title: "EC2", subtitle: "City of London, Shoreditch, Liverpool St, London", fullAddress: "EC2, City of London, UK", icon: "📮" },
+  { title: "SE1", subtitle: "South Bank, London Bridge, Waterloo, London", fullAddress: "SE1, Southwark & Lambeth, London, UK", icon: "📮" },
+  { title: "E14", subtitle: "Canary Wharf, Isle of Dogs, Poplar, London", fullAddress: "E14, Tower Hamlets, London, UK", icon: "📮" },
+  { title: "M1", subtitle: "Manchester City Centre, Piccadilly, Manchester", fullAddress: "M1, Manchester, UK", icon: "📮" },
+  { title: "B1", subtitle: "Birmingham City Centre, New Street, Birmingham", fullAddress: "B1, Birmingham, UK", icon: "📮" },
+  { title: "BS1", subtitle: "Bristol City Centre, Harbourside, Bristol", fullAddress: "BS1, Bristol, UK", icon: "📮" },
+  { title: "LS1", subtitle: "Leeds City Centre, City Square, Leeds", fullAddress: "LS1, Leeds, UK", icon: "📮" },
+  { title: "G1", subtitle: "Glasgow City Centre, George Square, Glasgow", fullAddress: "G1, Glasgow, UK", icon: "📮" },
+  { title: "EH1", subtitle: "Edinburgh Old Town, Royal Mile, Edinburgh", fullAddress: "EH1, Edinburgh, UK", icon: "📮" }
+];
+
 export class AddressAutocomplete {
   /**
    * @param {Object} options
@@ -54,6 +132,7 @@ export class AddressAutocomplete {
     this.abortController = null;
     this.activeIndex = -1;
     this.currentItems = [];
+    this.queryCache = new Map();
 
     this._boundInput = this.handleInput.bind(this);
     this._boundKeydown = this.handleKeydown.bind(this);
@@ -67,6 +146,17 @@ export class AddressAutocomplete {
     this.bindEvents();
   }
 
+  findInternalMatches(query) {
+    if (!query || query.trim().length < 2) return [];
+    const q = query.trim().toLowerCase();
+    const qParts = q.split(/\s+/).filter(Boolean);
+
+    return INTERNAL_VENUE_INDEX.filter(item => {
+      const text = (item.title + ' ' + item.subtitle + ' ' + item.fullAddress).toLowerCase();
+      return qParts.every(part => text.includes(part));
+    }).slice(0, 6);
+  }
+
   injectStyles() {
     if (typeof document === 'undefined') return;
     if (document.getElementById('shared-address-autocomplete-styles')) return;
@@ -193,10 +283,30 @@ export class AddressAutocomplete {
 
   handleInput() {
     clearTimeout(this.debounceTimer);
-    const query = this.input.value;
+    const query = (this.input.value || '').trim();
+
+    if (query.length < 2) {
+      this.close();
+      return;
+    }
+
+    // ⚡ 1. In-memory query cache check (0ms instant response)
+    const cacheKey = query.toLowerCase();
+    if (this.queryCache && this.queryCache.has(cacheKey)) {
+      this.render(this.queryCache.get(cacheKey));
+      return;
+    }
+
+    // ⚡ 2. Instant internal algorithm match (0ms instant response)
+    const localMatches = this.findInternalMatches(query);
+    if (localMatches.length > 0) {
+      this.render(localMatches);
+    }
+
+    // ⚡ 3. Short 100ms debounce for background remote enrichment
     this.debounceTimer = setTimeout(() => {
-      this.search(query);
-    }, 300);
+      this.search(query, localMatches);
+    }, 100);
   }
 
   handleKeydown(e) {
@@ -371,10 +481,14 @@ export class AddressAutocomplete {
   }
 
   async fetchPhotonVenues(query, signal) {
-    const bbox = '-7.57,49.96,1.68,58.64';
-    const url = `https://photon.komoot.io/api/?q=${encodeURIComponent(query)}&limit=6&lang=en&bbox=${bbox}`;
+    const isUkPostcode = UK_POSTCODE_REGEX.test((query || '').trim());
+    const bboxParam = isUkPostcode ? '&bbox=-7.57,49.96,1.68,58.64' : '';
+    const url = `https://photon.komoot.io/api/?q=${encodeURIComponent(query)}&limit=6&lang=en${bboxParam}`;
     try {
-      const res = await fetch(url, { signal });
+      const timeoutPromise = new Promise((_, reject) =>
+        setTimeout(() => reject(new Error('Timeout')), 1500)
+      );
+      const res = await Promise.race([fetch(url, { signal }), timeoutPromise]);
       if (!res.ok) return [];
       const data = await res.json();
       if (!data.features || !Array.isArray(data.features)) return [];
@@ -410,39 +524,74 @@ export class AddressAutocomplete {
     }
   }
 
-  async search(query) {
+  async search(query, initialMatches = []) {
     const trimmed = (query || '').trim();
     if (trimmed.length < 2) {
       this.close();
       return;
     }
 
+    const cacheKey = trimmed.toLowerCase();
+    if (this.queryCache && this.queryCache.has(cacheKey)) {
+      this.render(this.queryCache.get(cacheKey));
+      return;
+    }
+
     if (this.abortController) {
       this.abortController.abort();
     }
     this.abortController = new AbortController();
     const signal = this.abortController.signal;
 
-    this.showSpinner(true);
+    const baseMatches = initialMatches && initialMatches.length > 0
+      ? [...initialMatches]
+      : this.findInternalMatches(trimmed);
+
+    // Only show spinner if no instant matches are already rendered
+    if (baseMatches.length === 0) {
+      this.showSpinner(true);
+    }
 
     try {
-      let results = [];
+      let results = [...baseMatches];
+      let remoteResults = [];
       if (this.options.country === 'uk' && UK_POSTCODE_REGEX.test(trimmed)) {
-        results = await this.fetchPostcodes(trimmed, signal);
-        if (results.length < 3) {
+        remoteResults = await this.fetchPostcodes(trimmed, signal);
+        if (remoteResults.length < 3) {
           const venueResults = await this.fetchPhotonVenues(trimmed, signal);
-          results = [...results, ...venueResults].slice(0, 6);
+          remoteResults = [...remoteResults, ...venueResults].slice(0, 6);
         }
       } else {
-        results = await this.fetchPhotonVenues(trimmed, signal);
+        remoteResults = await this.fetchPhotonVenues(trimmed, signal);
+      }
+
+      // Merge and deduplicate by title + subtitle
+      const seen = new Set(results.map(r => (r.title + '|' + (r.subtitle || '')).toLowerCase()));
+      remoteResults.forEach(r => {
+        const key = (r.title + '|' + (r.subtitle || '')).toLowerCase();
+        if (!seen.has(key)) {
+          seen.add(key);
+          results.push(r);
+        }
+      });
+
+      results = results.slice(0, 6);
+      if (this.queryCache) {
+        this.queryCache.set(cacheKey, results);
       }
 
       this.showSpinner(false);
-      this.render(results);
+      if (results.length > 0) {
+        this.render(results);
+      } else {
+        this.close();
+      }
     } catch (err) {
       if (err.name !== 'AbortError') {
         this.showSpinner(false);
-        this.close();
+        if (baseMatches.length === 0) {
+          this.close();
+        }
       }
     }
   }

package/AiBillSplitter.js

@@ -0,0 +1,230 @@
+import { axiosWrapper } from './axiosWrapper.js';
+
+/**
+ * AiBillSplitter
+ *
+ * Orchestrates receipt scanning via Multimodal Vision AI with client-side image pre-compression,
+ * itemized split calculations, guest assignments, and dynamic tip allocation.
+ */
+export class AiBillSplitter {
+  /**
+   * @param {Object} options
+   * @param {string} [options.uploadUrl='/api/ai/scan-receipt']
+   * @param {number} [options.defaultTipPercent=10]
+   */
+  constructor(options = {}) {
+    this.uploadUrl = options.uploadUrl || '/api/ai/scan-receipt';
+    this.defaultTipPercent = options.defaultTipPercent !== undefined ? options.defaultTipPercent : 10;
+    this.items = [];
+    this.guests = []; // { id: string, name: string }
+    this.assignments = {}; // { [itemIndex: number]: string[] (guestIds) }
+    this.currency = 'GBP';
+  }
+
+  /**
+   * Client-side compression to eliminate VLM timeout and slash upload payload.
+   *
+   * @param {File|Blob} file
+   * @param {number} [maxDimension=1200]
+   * @param {number} [quality=0.8]
+   * @returns {Promise<Blob>}
+   */
+  static async compressImage(file, maxDimension = 1200, quality = 0.8) {
+    if (typeof document === 'undefined' || !file) {
+      return file;
+    }
+
+    return new Promise((resolve) => {
+      const img = new Image();
+      const reader = new FileReader();
+
+      reader.onload = (e) => {
+        img.onload = () => {
+          let { width, height } = img;
+          if (width > maxDimension || height > maxDimension) {
+            if (width > height) {
+              height = Math.round((height * maxDimension) / width);
+              width = maxDimension;
+            } else {
+              width = Math.round((width * maxDimension) / height);
+              height = maxDimension;
+            }
+          }
+
+          const canvas = document.createElement('canvas');
+          canvas.width = width;
+          canvas.height = height;
+          const ctx = canvas.getContext('2d');
+          ctx.drawImage(img, 0, 0, width, height);
+
+          canvas.toBlob(
+            (blob) => resolve(blob || file),
+            'image/jpeg',
+            quality
+          );
+        };
+        img.src = e.target.result;
+      };
+
+      reader.onerror = () => resolve(file);
+      reader.readAsDataURL(file);
+    });
+  }
+
+  /**
+   * Upload receipt photo and retrieve parsed line items.
+   *
+   * @param {File|Blob} file
+   * @returns {Promise<{success: boolean, items: Array, total: number, currency: string, error?: string}>}
+   */
+  async scanReceipt(file) {
+    if (!file) {
+      return { success: false, items: [], total: 0, currency: this.currency, error: 'No file provided.' };
+    }
+
+    try {
+      const compressedBlob = await AiBillSplitter.compressImage(file);
+      const formData = new FormData();
+      formData.append('receipt', compressedBlob, 'receipt.jpg');
+
+      const response = await axiosWrapper.post(this.uploadUrl, formData, {
+        headers: { 'Content-Type': 'multipart/form-data' }
+      });
+
+      const data = response.data || {};
+      if (data.success && Array.isArray(data.items)) {
+        this.items = data.items.map((it, idx) => ({
+          index: idx,
+          name: it.name || 'Item',
+          price: Number(it.price) || 0,
+          quantity: Number(it.quantity) || 1
+        }));
+        this.currency = data.currency || 'GBP';
+        this.assignments = {};
+      }
+
+      return data;
+    } catch (err) {
+      return {
+        success: false,
+        items: [],
+        total: 0,
+        currency: this.currency,
+        error: err.response?.data?.message || err.message || 'Receipt scan failed.'
+      };
+    }
+  }
+
+  /**
+   * Add a guest to the split roster
+   * @param {string} id
+   * @param {string} name
+   */
+  addGuest(id, name) {
+    if (!id || !name) return;
+    if (!this.guests.some(g => g.id === id)) {
+      this.guests.push({ id, name });
+    }
+  }
+
+  /**
+   * Remove a guest
+   * @param {string} id
+   */
+  removeGuest(id) {
+    this.guests = this.guests.filter(g => g.id !== id);
+    // Unassign from all items
+    for (const idx in this.assignments) {
+      this.assignments[idx] = this.assignments[idx].filter(gId => gId !== id);
+    }
+  }
+
+  /**
+   * Assign an item to a guest (can be split across multiple guests)
+   * @param {number} itemIndex
+   * @param {string} guestId
+   */
+  assignItem(itemIndex, guestId) {
+    if (!this.assignments[itemIndex]) {
+      this.assignments[itemIndex] = [];
+    }
+    if (!this.assignments[itemIndex].includes(guestId)) {
+      this.assignments[itemIndex].push(guestId);
+    }
+  }
+
+  /**
+   * Unassign an item from a guest
+   * @param {number} itemIndex
+   * @param {string} guestId
+   */
+  unassignItem(itemIndex, guestId) {
+    if (this.assignments[itemIndex]) {
+      this.assignments[itemIndex] = this.assignments[itemIndex].filter(gId => gId !== guestId);
+    }
+  }
+
+  /**
+   * Calculate final amounts per guest with tip
+   * @param {number} [tipPercent]
+   * @returns {Object}
+   */
+  calculateShares(tipPercent) {
+    const tip = tipPercent !== undefined ? tipPercent : this.defaultTipPercent;
+    const guestTotals = {};
+    this.guests.forEach(g => {
+      guestTotals[g.id] = { id: g.id, name: g.name, subtotal: 0, items: [] };
+    });
+
+    let assignedSubtotal = 0;
+    const unassignedItems = [];
+
+    this.items.forEach((item, idx) => {
+      const assignedGuests = this.assignments[idx] || [];
+      const totalItemCost = item.price * item.quantity;
+
+      if (assignedGuests.length === 0) {
+        unassignedItems.push(item);
+      } else {
+        const splitCost = totalItemCost / assignedGuests.length;
+        assignedGuests.forEach(gId => {
+          if (guestTotals[gId]) {
+            guestTotals[gId].subtotal += splitCost;
+            guestTotals[gId].items.push({
+              name: item.name,
+              fullPrice: totalItemCost,
+              portionCost: Math.round(splitCost * 100) / 100,
+              splitCount: assignedGuests.length
+            });
+          }
+        });
+        assignedSubtotal += totalItemCost;
+      }
+    });
+
+    const shares = Object.values(guestTotals).map(g => {
+      const sub = Math.round(g.subtotal * 100) / 100;
+      const guestTip = Math.round((sub * (tip / 100)) * 100) / 100;
+      return {
+        id: g.id,
+        name: g.name,
+        subtotal: sub,
+        tip: guestTip,
+        total: Math.round((sub + guestTip) * 100) / 100,
+        items: g.items
+      };
+    });
+
+    const totalTip = shares.reduce((acc, s) => acc + s.tip, 0);
+
+    return {
+      currency: this.currency,
+      tipPercentage: tip,
+      assignedSubtotal: Math.round(assignedSubtotal * 100) / 100,
+      totalTip: Math.round(totalTip * 100) / 100,
+      grandTotal: Math.round((assignedSubtotal + totalTip) * 100) / 100,
+      guestShares: shares,
+      unassignedItems
+    };
+  }
+}

package/AiEntertainmentPrompt.js

@@ -0,0 +1,130 @@
+import { axiosWrapper } from './axiosWrapper.js';
+import { AiPrivacyGuard } from './AiPrivacyGuard.js';
+
+/**
+ * AiEntertainmentPrompt
+ *
+ * Client interface for creative social AI features:
+ * - AI Speechwriter & Roast Master
+ * - AI Household Dispute & Chore Arbiter
+ */
+export class AiEntertainmentPrompt {
+  /**
+   * Request an AI celebration speech or comedic roast.
+   *
+   * @param {Object} params
+   * @param {string} params.honoureeName
+   * @param {string} params.occasion
+   * @param {string[]} [params.anecdotes=[]]
+   * @param {'humorous_roast'|'heartfelt'|'peaky_blinders'|'concise_card'} [params.tone='humorous_roast']
+   * @param {string} [params.endpoint='/api/ai/speech']
+   * @returns {Promise<{success: boolean, title: string, speechText: string, toast: string, tips: string[], error?: string}>}
+   */
+  static async requestSpeech({
+    honoureeName,
+    occasion,
+    anecdotes = [],
+    tone = 'humorous_roast',
+    endpoint = '/api/ai/speech'
+  }) {
+    if (!honoureeName || !occasion) {
+      return {
+        success: false,
+        title: '',
+        speechText: '',
+        toast: '',
+        tips: [],
+        error: 'Honouree name and occasion are required.'
+      };
+    }
+
+    try {
+      const response = await axiosWrapper.post(endpoint, {
+        honouree_name: honoureeName,
+        occasion,
+        anecdotes: anecdotes.map(a => AiPrivacyGuard.scrubText(a)),
+        tone
+      });
+
+      const d = response.data || {};
+      return {
+        success: d.success !== false,
+        title: d.title || `A Toast to ${honoureeName}`,
+        speechText: d.speech_text || d.speechText || '',
+        toast: d.suggested_toast || d.toast || `To ${honoureeName}!`,
+        tips: d.delivery_tips || d.tips || [],
+        error: d.error
+      };
+    } catch (err) {
+      return {
+        success: false,
+        title: '',
+        speechText: '',
+        toast: '',
+        tips: [],
+        error: err.response?.data?.message || err.message || 'Speech generation failed.'
+      };
+    }
+  }
+
+  /**
+   * Request an impartial and humorous household dispute arbitration.
+   *
+   * @param {Object} params
+   * @param {string} params.partyAName
+   * @param {string} params.partyAClaim
+   * @param {string} params.partyBName
+   * @param {string} params.partyBClaim
+   * @param {string} [params.context='household_chores']
+   * @param {string} [params.endpoint='/api/ai/arbitrate-dispute']
+   * @returns {Promise<{success: boolean, verdict: string, plan: Object, penalty: string, quip: string, error?: string}>}
+   */
+  static async arbitrateDispute({
+    partyAName,
+    partyAClaim,
+    partyBName,
+    partyBClaim,
+    context = 'household_chores',
+    endpoint = '/api/ai/arbitrate-dispute'
+  }) {
+    if (!partyAName || !partyAClaim || !partyBName || !partyBClaim) {
+      return {
+        success: false,
+        verdict: '',
+        plan: {},
+        penalty: '',
+        quip: '',
+        error: 'Both parties must submit their names and arguments.'
+      };
+    }
+
+    try {
+      const response = await axiosWrapper.post(endpoint, {
+        party_a_name: partyAName,
+        party_a_claim: AiPrivacyGuard.scrubText(partyAClaim),
+        party_b_name: partyBName,
+        party_b_claim: AiPrivacyGuard.scrubText(partyBClaim),
+        context
+      });
+
+      const d = response.data || {};
+      return {
+        success: d.success !== false,
+        verdict: d.verdict || 'The court has spoken.',
+        plan: d.compromise_action_plan || d.plan || {},
+        penalty: d.penalty_or_chore || d.penalty || '',
+        quip: d.closing_quip || d.quip || '',
+        error: d.error
+      };
+    } catch (err) {
+      return {
+        success: false,
+        verdict: '',
+        plan: {},
+        penalty: '',
+        quip: '',
+        error: err.response?.data?.message || err.message || 'Dispute arbitration failed.'
+      };
+    }
+  }
+}