@seatlayer/core 0.1.3 → 0.1.4

package/dist/index.d.cts

@@ -425,6 +425,12 @@ interface ISeatmapRenderer {
     setCategoryHighlight?(key: string | null): void;
     /** Dim the seats of these section/zone ids (organizer manager: held-back inventory). */
     setDimmedSections?(ids: string[] | null): void;
+    /**
+     * Colorblind-safe mode: category hues switch to an Okabe-Ito palette and
+     * booked seats render hollow (a non-color cue), so seat state never relies
+     * on hue alone. Off (the default) renders exactly as before.
+     */
+    setColorblindSafe?(on: boolean): void;
     /**
      * Switch the projection. `'flat'` = normal top-down; `'isometric'` = the "3D"
      * view (affine skew/rotate + elevation lift), hit-testing preserved in screen
@@ -645,6 +651,10 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private statusById;
     private catColor;
     private theme;
+    /** Colorblind-safe mode (Okabe-Ito hues + hollow booked seats). */
+    private colorblind;
+    /** Category order from the doc — the stable index into the CB palette. */
+    private catOrder;
     private selection;
     private selectionRings;
     private hoverRing;
@@ -797,8 +807,15 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private renderSeats;
     /** A booth renders as a click-selectable rounded block (dims from the doc). */
     private renderBoothUnit;
+    /** The category's display color — Okabe-Ito hue when colorblind-safe is on. */
+    private seatBaseColor;
     /** Apply fill/stroke/opacity for a seat's current status + selection. */
     private paintSeat;
+    /**
+     * Colorblind-safe mode: swap category hues for the Okabe-Ito palette and
+     * render booked seats hollow. Off restores the exact default rendering.
+     */
+    setColorblindSafe(on: boolean): void;
     /**
      * Dim the seats of these section/zone ids (organizer manager use) so held-back
      * inventory is visually distinct on the canvas without hiding it. `null`/empty
@@ -1019,6 +1036,12 @@ interface PickerCallbacks extends RendererCallbacks {
     onSectionFocus?: (summary: SectionSummary | null) => void;
     /** A deck was tapped in the 3D all-floors overview — host enters that floor in 2D. */
     onDeckTap?: (floorId: string) => void;
+    /**
+     * Non-blocking selection advice (localized): currently the orphan-seat hint —
+     * the selection would strand a single free seat between unavailable
+     * neighbors. `null` clears a previously shown hint. Never prevents anything.
+     */
+    onHint?: (message: string | null) => void;
     onError?: (err: unknown) => void;
 }
 interface PickerOptions extends PickerCallbacks {
@@ -1031,6 +1054,8 @@ interface PickerOptions extends PickerCallbacks {
     currency?: string;
     /** Flash a pulse when a seat we didn't touch goes free→taken (live-activity cue). */
     flashOnLiveChange?: boolean;
+    /** Start in colorblind-safe rendering (Okabe-Ito hues + hollow booked seats). */
+    colorblindSafe?: boolean;
 }
 declare class PickerController {
     private readonly opts;
@@ -1162,6 +1187,17 @@ declare class PickerController {
     /** PickerSeats (with chosen tier) for a set of held labels. */
     private seatsForLabels;
     private emitSelectionChange;
+    /** Whether the last emitted hint was non-null (avoids clearing repeatedly). */
+    private hintShown;
+    /**
+     * Orphan-seat advice on manual selection: when the buyer's current picks
+     * strand one (or more) single free seats between unavailable same-row
+     * neighbors, surface a localized, non-blocking hint. Cleared (null) as soon
+     * as the selection stops stranding anyone.
+     */
+    private emitOrphanHint;
+    /** Toggle colorblind-safe rendering at runtime (see PickerOptions.colorblindSafe). */
+    setColorblindSafe(on: boolean): void;
     private emitError;
     private holdCovers;
     private handle409Conflicts;

package/dist/index.d.ts

@@ -425,6 +425,12 @@ interface ISeatmapRenderer {
     setCategoryHighlight?(key: string | null): void;
     /** Dim the seats of these section/zone ids (organizer manager: held-back inventory). */
     setDimmedSections?(ids: string[] | null): void;
+    /**
+     * Colorblind-safe mode: category hues switch to an Okabe-Ito palette and
+     * booked seats render hollow (a non-color cue), so seat state never relies
+     * on hue alone. Off (the default) renders exactly as before.
+     */
+    setColorblindSafe?(on: boolean): void;
     /**
      * Switch the projection. `'flat'` = normal top-down; `'isometric'` = the "3D"
      * view (affine skew/rotate + elevation lift), hit-testing preserved in screen
@@ -645,6 +651,10 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private statusById;
     private catColor;
     private theme;
+    /** Colorblind-safe mode (Okabe-Ito hues + hollow booked seats). */
+    private colorblind;
+    /** Category order from the doc — the stable index into the CB palette. */
+    private catOrder;
     private selection;
     private selectionRings;
     private hoverRing;
@@ -797,8 +807,15 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private renderSeats;
     /** A booth renders as a click-selectable rounded block (dims from the doc). */
     private renderBoothUnit;
+    /** The category's display color — Okabe-Ito hue when colorblind-safe is on. */
+    private seatBaseColor;
     /** Apply fill/stroke/opacity for a seat's current status + selection. */
     private paintSeat;
+    /**
+     * Colorblind-safe mode: swap category hues for the Okabe-Ito palette and
+     * render booked seats hollow. Off restores the exact default rendering.
+     */
+    setColorblindSafe(on: boolean): void;
     /**
      * Dim the seats of these section/zone ids (organizer manager use) so held-back
      * inventory is visually distinct on the canvas without hiding it. `null`/empty
@@ -1019,6 +1036,12 @@ interface PickerCallbacks extends RendererCallbacks {
     onSectionFocus?: (summary: SectionSummary | null) => void;
     /** A deck was tapped in the 3D all-floors overview — host enters that floor in 2D. */
     onDeckTap?: (floorId: string) => void;
+    /**
+     * Non-blocking selection advice (localized): currently the orphan-seat hint —
+     * the selection would strand a single free seat between unavailable
+     * neighbors. `null` clears a previously shown hint. Never prevents anything.
+     */
+    onHint?: (message: string | null) => void;
     onError?: (err: unknown) => void;
 }
 interface PickerOptions extends PickerCallbacks {
@@ -1031,6 +1054,8 @@ interface PickerOptions extends PickerCallbacks {
     currency?: string;
     /** Flash a pulse when a seat we didn't touch goes free→taken (live-activity cue). */
     flashOnLiveChange?: boolean;
+    /** Start in colorblind-safe rendering (Okabe-Ito hues + hollow booked seats). */
+    colorblindSafe?: boolean;
 }
 declare class PickerController {
     private readonly opts;
@@ -1162,6 +1187,17 @@ declare class PickerController {
     /** PickerSeats (with chosen tier) for a set of held labels. */
     private seatsForLabels;
     private emitSelectionChange;
+    /** Whether the last emitted hint was non-null (avoids clearing repeatedly). */
+    private hintShown;
+    /**
+     * Orphan-seat advice on manual selection: when the buyer's current picks
+     * strand one (or more) single free seats between unavailable same-row
+     * neighbors, surface a localized, non-blocking hint. Cleared (null) as soon
+     * as the selection stops stranding anyone.
+     */
+    private emitOrphanHint;
+    /** Toggle colorblind-safe rendering at runtime (see PickerOptions.colorblindSafe). */
+    setColorblindSafe(on: boolean): void;
     private emitError;
     private holdCovers;
     private handle409Conflicts;

package/dist/index.js

@@ -500,7 +500,9 @@ var en = {
   "picker.seatsHeld": "Seats held \u2014 {time}",
   "picker.holdExpired": "Your hold expired \u2014 the seats were released. Pick again.",
   "picker.seatTaken": "Seat {label} was just taken by another buyer.",
-  "picker.poweredBy": "Powered by SeatMap",
+  "picker.poweredBy": "Powered by SeatLayer",
+  "picker.colorblind": "Colorblind-friendly colors",
+  "picker.orphanHint": "This leaves a single seat stranded \u2014 consider shifting one seat over.",
   "picker.seats.one": "{count} seat",
   "picker.seats.other": "{count} seats",
   // renderer (drawn on the Konva map — shared by the embed SDK)
@@ -617,6 +619,7 @@ var ZONE_SUB_PX = 12;
 var HELD_FILL = "#6b7280";
 var TAKEN_FILL = "#374151";
 var NFS_STROKE = "#4b5563";
+var CB_PALETTE = ["#E69F00", "#56B4E9", "#009E73", "#F0E442", "#0072B2", "#D55E00", "#CC79A7"];
 var ACCESS_RING = {
   wheelchair: "#3b82f6",
   companion: "#8b5cf6",
@@ -719,6 +722,10 @@ var _SeatmapRenderer = class _SeatmapRenderer {
     this.statusById = /* @__PURE__ */ new Map();
     this.catColor = /* @__PURE__ */ new Map();
     this.theme = {};
+    /** Colorblind-safe mode (Okabe-Ito hues + hollow booked seats). */
+    this.colorblind = false;
+    /** Category order from the doc — the stable index into the CB palette. */
+    this.catOrder = [];
     this.selection = /* @__PURE__ */ new Set();
     this.selectionRings = /* @__PURE__ */ new Map();
     this.focusedId = null;
@@ -969,6 +976,7 @@ var _SeatmapRenderer = class _SeatmapRenderer {
     this.hoverRing.radius(this.seatR + 2);
     this.catColor.clear();
     this.catPrice.clear();
+    this.catOrder = doc.categories.map((c) => c.key);
     for (const c of doc.categories) {
       this.catColor.set(c.key, c.color);
       if (typeof c.price === "number") this.catPrice.set(c.key, c.price);
@@ -1492,12 +1500,18 @@ var _SeatmapRenderer = class _SeatmapRenderer {
     this.hasBoothText = true;
     target.add(t2);
   }
+  /** The category's display color — Okabe-Ito hue when colorblind-safe is on. */
+  seatBaseColor(categoryKey) {
+    if (!this.colorblind) return this.catColor.get(categoryKey) ?? "#6e7bff";
+    const idx = this.catOrder.indexOf(categoryKey);
+    return CB_PALETTE[(idx >= 0 ? idx : 0) % CB_PALETTE.length];
+  }
   /** Apply fill/stroke/opacity for a seat's current status + selection. */
   paintSeat(c, id) {
     const seat = this.seatById.get(id);
     const status = this.statusById.get(id) ?? "free";
     const selected = this.selection.has(id);
-    const base = this.catColor.get(seat.categoryKey) ?? "#6e7bff";
+    const base = this.seatBaseColor(seat.categoryKey);
     c.dash([]);
     c.strokeWidth(0);
     c.stroke("");
@@ -1510,8 +1524,15 @@ var _SeatmapRenderer = class _SeatmapRenderer {
         c.fill(HELD_FILL);
         break;
       case "booked":
-        c.fill(TAKEN_FILL);
-        c.opacity(0.45);
+        if (this.colorblind) {
+          c.fill("rgba(0,0,0,0)");
+          c.stroke(TAKEN_FILL);
+          c.strokeWidth(1.5);
+          c.opacity(0.9);
+        } else {
+          c.fill(TAKEN_FILL);
+          c.opacity(0.45);
+        }
         break;
       case "not_for_sale":
         c.fill(TAKEN_FILL);
@@ -1533,6 +1554,24 @@ var _SeatmapRenderer = class _SeatmapRenderer {
       }
     }
   }
+  /**
+   * Colorblind-safe mode: swap category hues for the Okabe-Ito palette and
+   * render booked seats hollow. Off restores the exact default rendering.
+   */
+  setColorblindSafe(on) {
+    if (on === this.colorblind) return;
+    this.colorblind = on;
+    for (const seat of this.seats) {
+      const c = this.circleById.get(seat.id);
+      if (c) this.paintSeat(c, seat.id);
+    }
+    if (this.cached) {
+      this.seatLayer.clearCache();
+      this.cacheSeatLayer();
+    } else {
+      this.seatLayer.batchDraw();
+    }
+  }
   /**
    * Dim the seats of these section/zone ids (organizer manager use) so held-back
    * inventory is visually distinct on the canvas without hiding it. `null`/empty
@@ -2471,6 +2510,38 @@ function createRenderer(container, opts) {
   return new SeatmapRenderer(container, opts);
 }
 
+// src/core/orphans.ts
+function seatIndex(id) {
+  const n = Number(id.slice(id.lastIndexOf(":") + 1));
+  return Number.isFinite(n) ? n : -1;
+}
+function strandedSingles(seats, statusOf, selectedIds) {
+  const rows = /* @__PURE__ */ new Map();
+  for (const s of seats) {
+    if (s.kind === "booth") continue;
+    const list = rows.get(s.rowId);
+    if (list) list.push(s);
+    else rows.set(s.rowId, [s]);
+  }
+  const unavailable = (s) => selectedIds.has(s.id) || statusOf(s.id) !== "free";
+  const out = [];
+  for (const list of rows.values()) {
+    if (list.length < 3) continue;
+    list.sort((a, b) => seatIndex(a.id) - seatIndex(b.id));
+    for (let i = 1; i < list.length - 1; i++) {
+      const seat = list[i];
+      if (unavailable(seat)) continue;
+      const left = list[i - 1];
+      const right = list[i + 1];
+      if (seatIndex(seat.id) - seatIndex(left.id) !== 1 || seatIndex(right.id) - seatIndex(seat.id) !== 1) continue;
+      if (!unavailable(left) || !unavailable(right)) continue;
+      if (!selectedIds.has(left.id) && !selectedIds.has(right.id)) continue;
+      out.push(seat);
+    }
+  }
+  return out;
+}
+
 // src/picker/PickerController.ts
 var DEFAULT_MAX_SELECTION = 10;
 var MAX_BACKOFF_MS = 15e3;
@@ -2505,6 +2576,8 @@ var PickerController = class {
     // hold state
     this.hold_ = null;
     this.expiryTimer = null;
+    /** Whether the last emitted hint was non-null (avoids clearing repeatedly). */
+    this.hintShown = false;
     this.opts = options;
     this.api = options.transport;
     this.key = options.eventKey;
@@ -2600,6 +2673,7 @@ var PickerController = class {
       return null;
     }
     renderer.setChart(this.visibleDoc());
+    if (this.opts.colorblindSafe) renderer.setColorblindSafe?.(true);
     if (seats) this.applySeatsMap(seats);
     this.connect();
     return {
@@ -2971,6 +3045,31 @@ var PickerController = class {
   }
   emitSelectionChange() {
     this.opts.onSelectionChange?.(this.getSelection());
+    this.emitOrphanHint();
+  }
+  /**
+   * Orphan-seat advice on manual selection: when the buyer's current picks
+   * strand one (or more) single free seats between unavailable same-row
+   * neighbors, surface a localized, non-blocking hint. Cleared (null) as soon
+   * as the selection stops stranding anyone.
+   */
+  emitOrphanHint() {
+    if (!this.opts.onHint) return;
+    const r = this.renderer;
+    if (!r) return;
+    const selected = new Set(r.getSelection().map((s) => s.id));
+    const stranded = selected.size ? strandedSingles(this.seatById.values(), (id) => r.getStatus(id), selected) : [];
+    if (stranded.length > 0) {
+      this.hintShown = true;
+      this.opts.onHint(t("picker.orphanHint"));
+    } else if (this.hintShown) {
+      this.hintShown = false;
+      this.opts.onHint(null);
+    }
+  }
+  /** Toggle colorblind-safe rendering at runtime (see PickerOptions.colorblindSafe). */
+  setColorblindSafe(on) {
+    this.renderer?.setColorblindSafe?.(on);
   }
   emitError(err) {
     if (this.opts.onError) this.opts.onError(err);
@@ -3107,9 +3206,9 @@ var PickerController = class {
 
 // src/i18n/bundles.ts
 var LOADERS = {
-  es: () => import("./es-UM4ZS357.js").then((m) => ({ default: m.es })),
-  de: () => import("./de-Y3E6YTGP.js").then((m) => ({ default: m.de })),
-  fr: () => import("./fr-IGRD2M4W.js").then((m) => ({ default: m.fr }))
+  es: () => import("./es-YNYMMP37.js").then((m) => ({ default: m.es })),
+  de: () => import("./de-A4KJQ374.js").then((m) => ({ default: m.de })),
+  fr: () => import("./fr-DQ4KWKKF.js").then((m) => ({ default: m.fr }))
 };
 var loaded = /* @__PURE__ */ new Set(["en"]);
 async function loadLocale(code) {