@drmxrcy/tcg-lorcana 0.0.0-202602060544

package/src/zones/zone-config.ts

@@ -0,0 +1,150 @@
+/**
+ * Zone Configuration (Section 8)
+ *
+ * Lorcana has 5 zones with distinct visibility and ordering rules:
+ * - Deck (8.2): Private, ordered, facedown
+ * - Hand (8.3): Private, unordered
+ * - Play (8.4): Public, unordered
+ * - Inkwell (8.5): Public count, facedown cards
+ * - Discard (8.6): Public, unordered
+ */
+
+export const ZONE_IDS = ["deck", "hand", "play", "inkwell", "discard"] as const;
+export type LorcanaZoneId = (typeof ZONE_IDS)[number];
+
+export type ZoneVisibility = "public" | "private" | "hidden_identity";
+
+export interface ZoneConfig {
+  id: LorcanaZoneId;
+  visibility: ZoneVisibility;
+  ordered: boolean;
+  faceDown: boolean;
+  maxSize?: number;
+}
+
+/**
+ * Zone configurations for Lorcana
+ */
+export const LORCANA_ZONES: Record<LorcanaZoneId, ZoneConfig> = {
+  /**
+   * Deck (Rule 8.2)
+   * - Private to owner
+   * - Ordered (has top and bottom)
+   * - Face down
+   */
+  deck: {
+    id: "deck",
+    visibility: "private",
+    ordered: true,
+    faceDown: true,
+  },
+
+  /**
+   * Hand (Rule 8.3)
+   * - Private to owner
+   * - Unordered
+   * - Face down to opponents
+   */
+  hand: {
+    id: "hand",
+    visibility: "private",
+    ordered: false,
+    faceDown: false,
+  },
+
+  /**
+   * Play (Rule 8.4)
+   * - Public to all players
+   * - Unordered
+   * - Face up
+   */
+  play: {
+    id: "play",
+    visibility: "public",
+    ordered: false,
+    faceDown: false,
+  },
+
+  /**
+   * Inkwell (Rule 8.5)
+   * - Count is public
+   * - Card identity is hidden (facedown)
+   * - Unordered
+   */
+  inkwell: {
+    id: "inkwell",
+    visibility: "hidden_identity",
+    ordered: false,
+    faceDown: true,
+  },
+
+  /**
+   * Discard (Rule 8.6)
+   * - Public to all players
+   * - Unordered (but order of discard may be tracked)
+   * - Face up
+   */
+  discard: {
+    id: "discard",
+    visibility: "public",
+    ordered: false,
+    faceDown: false,
+  },
+};
+
+/**
+ * Check if a zone ID is valid
+ */
+export function isLorcanaZoneId(value: unknown): value is LorcanaZoneId {
+  return typeof value === "string" && ZONE_IDS.includes(value as LorcanaZoneId);
+}
+
+/**
+ * Get zone configuration by ID
+ */
+export function getZoneConfig(zoneId: LorcanaZoneId): ZoneConfig {
+  return LORCANA_ZONES[zoneId];
+}
+
+/**
+ * Check if a zone is visible to a specific player
+ */
+export function isZoneVisibleTo(
+  zoneId: LorcanaZoneId,
+  zoneOwnerId: string,
+  viewerId: string,
+): boolean {
+  const config = LORCANA_ZONES[zoneId];
+
+  if (config.visibility === "public") {
+    return true;
+  }
+
+  if (config.visibility === "private") {
+    return zoneOwnerId === viewerId;
+  }
+
+  // hidden_identity - count is public, but not the cards themselves
+  return false;
+}
+
+/**
+ * Check if zone card identities are visible to a player
+ */
+export function areCardsVisibleIn(
+  zoneId: LorcanaZoneId,
+  zoneOwnerId: string,
+  viewerId: string,
+): boolean {
+  const config = LORCANA_ZONES[zoneId];
+
+  if (config.visibility === "public") {
+    return true;
+  }
+
+  if (config.visibility === "private" && zoneOwnerId === viewerId) {
+    return true;
+  }
+
+  return false;
+}