@ankhorage/zora 21.0.22 → 21.1.0

package/dist/features/tabletop/utils/createPokerTrainingTableState.d.ts

@@ -0,0 +1,13 @@
+import type { CreatePokerTrainingTableStateOptions, PokerTrainingTableState, PokerTrainingTaskTableData } from '../../../types/tabletop';
+/***
+ * Adapts the table-relevant subset of a poker training task to generic tabletop presentation state.
+ *
+ * The canonical poker ring for the task table size is rotated so the hero occupies the first
+ * (bottom) tabletop seat. Players omitted by the task are reconstructed as folded with the
+ * configured default stack.
+ *
+ * Accepts serializable poker training task data plus presentation defaults for omitted fields and
+ * returns seats and shared-table content ready for `TabletopTable`.
+ */
+export declare function createPokerTrainingTableState(task: PokerTrainingTaskTableData, { defaultStackBigBlinds }?: CreatePokerTrainingTableStateOptions): PokerTrainingTableState;
+//# sourceMappingURL=createPokerTrainingTableState.d.ts.map

package/dist/features/tabletop/utils/createPokerTrainingTableState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createPokerTrainingTableState.d.ts","sourceRoot":"","sources":["../../../../src/features/tabletop/utils/createPokerTrainingTableState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oCAAoC,EAGpC,uBAAuB,EACvB,0BAA0B,EAE3B,MAAM,yBAAyB,CAAC;AAGjC;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,0BAA0B,EAChC,EAAE,qBAA2B,EAAE,GAAE,oCAAyC,GACzE,uBAAuB,CAqCzB"}

package/dist/features/tabletop/utils/createPokerTrainingTableState.js

@@ -0,0 +1,112 @@
+import { createTabletopGameSeats } from './createTabletopGameSeats';
+/***
+ * Adapts the table-relevant subset of a poker training task to generic tabletop presentation state.
+ *
+ * The canonical poker ring for the task table size is rotated so the hero occupies the first
+ * (bottom) tabletop seat. Players omitted by the task are reconstructed as folded with the
+ * configured default stack.
+ *
+ * Accepts serializable poker training task data plus presentation defaults for omitted fields and
+ * returns seats and shared-table content ready for `TabletopTable`.
+ */
+export function createPokerTrainingTableState(task, { defaultStackBigBlinds = 100 } = {}) {
+    const tableSize = task.tableSize ?? '9max';
+    const positions = tableSize === '6max' ? sixMaxPokerPositions : nineMaxPokerPositions;
+    const bigBlind = task.blinds?.big;
+    const heroPosition = task.heroPosition ?? task.players?.find((player) => player.isHero)?.position;
+    const orderedPositions = rotatePokerPositions(positions, heroPosition);
+    const defaultStack = `${formatAmount(defaultStackBigBlinds)} BB`;
+    const participants = (task.players ?? []).map((player) => createPokerParticipantState(player, task, bigBlind));
+    const seats = createTabletopGameSeats({
+        seats: orderedPositions.map((position) => ({
+            id: position,
+            defaultState: {
+                label: position,
+                tokenLabel: position === 'BTN' ? 'D' : undefined,
+            },
+        })),
+        participants,
+        missingParticipantState: {
+            disabled: true,
+            muted: true,
+            sublabel: `${defaultStack} · Folded`,
+        },
+    });
+    return {
+        seatCount: positions.length,
+        seats,
+        centerCards: task.communityCards ?? [],
+        centerLabel: task.pot === undefined ? undefined : `Pot ${formatAmount(task.pot)}`,
+        centerSublabel: task.blinds === undefined
+            ? undefined
+            : `Blinds ${formatAmount(task.blinds.small)} / ${formatAmount(task.blinds.big)}`,
+        accessibilityLabel: createPokerAccessibilityLabel(tableSize, heroPosition, task),
+    };
+}
+const sixMaxPokerPositions = ['BTN', 'SB', 'BB', 'UTG', 'HJ', 'CO'];
+const nineMaxPokerPositions = [
+    'BTN',
+    'SB',
+    'BB',
+    'UTG',
+    'UTG+1',
+    'UTG+2',
+    'MP',
+    'HJ',
+    'CO',
+];
+/*** Rotates one canonical poker ring to place the hero at the bottom seat. */
+function rotatePokerPositions(positions, heroPosition) {
+    const heroIndex = positions.findIndex((position) => position === heroPosition);
+    if (heroIndex <= 0)
+        return positions;
+    return [...positions.slice(heroIndex), ...positions.slice(0, heroIndex)];
+}
+/*** Converts one poker participant record into a generic seat-state override. */
+function createPokerParticipantState(player, task, bigBlind) {
+    const isHero = player.isHero === true || player.position === task.heroPosition;
+    const cards = player.cards ?? (isHero ? task.heroCards : undefined);
+    const folded = player.folded === true;
+    return {
+        seatId: player.position,
+        state: {
+            cards,
+            disabled: folded,
+            faceDownCards: cards === undefined && !folded && !isHero ? 2 : undefined,
+            muted: folded,
+            selected: isHero,
+            sublabel: formatPlayerSublabel(player, bigBlind),
+        },
+    };
+}
+/*** Formats stack and optional committed chips as a compact seat sublabel. */
+function formatPlayerSublabel(player, bigBlind) {
+    const stack = player.stack === undefined ? undefined : formatChipStack(player.stack, bigBlind);
+    const bet = player.bet === undefined ? undefined : `Bet ${formatChipStack(player.bet, bigBlind)}`;
+    const parts = [stack, bet, player.folded === true ? 'Folded' : undefined].filter((part) => part !== undefined);
+    return parts.length === 0 ? undefined : parts.join(' · ');
+}
+/*** Formats chips as big blinds when a positive blind is known, otherwise as an amount. */
+function formatChipStack(amount, bigBlind) {
+    if (bigBlind !== undefined && bigBlind > 0) {
+        return `${formatAmount(amount / bigBlind)} BB`;
+    }
+    return `${formatAmount(amount)} chips`;
+}
+/*** Formats a numeric poker amount consistently across native and web runtimes. */
+function formatAmount(amount) {
+    return new Intl.NumberFormat('en-US', { maximumFractionDigits: 2 }).format(amount);
+}
+/*** Summarizes the reconstructed table for assistive technologies. */
+function createPokerAccessibilityLabel(tableSize, heroPosition, task) {
+    const parts = [`${tableSize === '6max' ? 'Six' : 'Nine'}-player poker table`];
+    if (heroPosition !== undefined)
+        parts.push(`Hero ${heroPosition}`);
+    if (task.pot !== undefined)
+        parts.push(`Pot ${formatAmount(task.pot)}`);
+    if (task.blinds !== undefined) {
+        parts.push(`Blinds ${formatAmount(task.blinds.small)} / ${formatAmount(task.blinds.big)}`);
+    }
+    return `${parts.join('. ')}.`;
+}
+//# sourceMappingURL=createPokerTrainingTableState.js.map

package/dist/features/tabletop/utils/createPokerTrainingTableState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createPokerTrainingTableState.js","sourceRoot":"","sources":["../../../../src/features/tabletop/utils/createPokerTrainingTableState.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  CreatePokerTrainingTableStateOptions,\n  PokerTrainingPlayer,\n  PokerTrainingTableSize,\n  PokerTrainingTableState,\n  PokerTrainingTaskTableData,\n  TabletopGameParticipantState,\n} from '../../../types/tabletop';\nimport { createTabletopGameSeats } from './createTabletopGameSeats';\n\n/***\n * Adapts the table-relevant subset of a poker training task to generic tabletop presentation state.\n *\n * The canonical poker ring for the task table size is rotated so the hero occupies the first\n * (bottom) tabletop seat. Players omitted by the task are reconstructed as folded with the\n * configured default stack.\n *\n * Accepts serializable poker training task data plus presentation defaults for omitted fields and\n * returns seats and shared-table content ready for `TabletopTable`.\n */\nexport function createPokerTrainingTableState(\n  task: PokerTrainingTaskTableData,\n  { defaultStackBigBlinds = 100 }: CreatePokerTrainingTableStateOptions = {},\n): PokerTrainingTableState {\n  const tableSize = task.tableSize ?? '9max';\n  const positions = tableSize === '6max' ? sixMaxPokerPositions : nineMaxPokerPositions;\n  const bigBlind = task.blinds?.big;\n  const heroPosition = task.heroPosition ?? task.players?.find((player) => player.isHero)?.position;\n  const orderedPositions = rotatePokerPositions(positions, heroPosition);\n  const defaultStack = `${formatAmount(defaultStackBigBlinds)} BB`;\n  const participants = (task.players ?? []).map((player) =>\n    createPokerParticipantState(player, task, bigBlind),\n  );\n  const seats = createTabletopGameSeats({\n    seats: orderedPositions.map((position) => ({\n      id: position,\n      defaultState: {\n        label: position,\n        tokenLabel: position === 'BTN' ? 'D' : undefined,\n      },\n    })),\n    participants,\n    missingParticipantState: {\n      disabled: true,\n      muted: true,\n      sublabel: `${defaultStack} · Folded`,\n    },\n  });\n\n  return {\n    seatCount: positions.length,\n    seats,\n    centerCards: task.communityCards ?? [],\n    centerLabel: task.pot === undefined ? undefined : `Pot ${formatAmount(task.pot)}`,\n    centerSublabel:\n      task.blinds === undefined\n        ? undefined\n        : `Blinds ${formatAmount(task.blinds.small)} / ${formatAmount(task.blinds.big)}`,\n    accessibilityLabel: createPokerAccessibilityLabel(tableSize, heroPosition, task),\n  };\n}\n\nconst sixMaxPokerPositions = ['BTN', 'SB', 'BB', 'UTG', 'HJ', 'CO'] as const;\nconst nineMaxPokerPositions = [\n  'BTN',\n  'SB',\n  'BB',\n  'UTG',\n  'UTG+1',\n  'UTG+2',\n  'MP',\n  'HJ',\n  'CO',\n] as const;\n\n/*** Rotates one canonical poker ring to place the hero at the bottom seat. */\nfunction rotatePokerPositions(\n  positions: readonly string[],\n  heroPosition: string | undefined,\n): readonly string[] {\n  const heroIndex = positions.findIndex((position) => position === heroPosition);\n  if (heroIndex <= 0) return positions;\n\n  return [...positions.slice(heroIndex), ...positions.slice(0, heroIndex)];\n}\n\n/*** Converts one poker participant record into a generic seat-state override. */\nfunction createPokerParticipantState(\n  player: PokerTrainingPlayer,\n  task: PokerTrainingTaskTableData,\n  bigBlind: number | undefined,\n): TabletopGameParticipantState {\n  const isHero = player.isHero === true || player.position === task.heroPosition;\n  const cards = player.cards ?? (isHero ? task.heroCards : undefined);\n  const folded = player.folded === true;\n\n  return {\n    seatId: player.position,\n    state: {\n      cards,\n      disabled: folded,\n      faceDownCards: cards === undefined && !folded && !isHero ? 2 : undefined,\n      muted: folded,\n      selected: isHero,\n      sublabel: formatPlayerSublabel(player, bigBlind),\n    },\n  };\n}\n\n/*** Formats stack and optional committed chips as a compact seat sublabel. */\nfunction formatPlayerSublabel(\n  player: PokerTrainingPlayer,\n  bigBlind: number | undefined,\n): string | undefined {\n  const stack = player.stack === undefined ? undefined : formatChipStack(player.stack, bigBlind);\n  const bet = player.bet === undefined ? undefined : `Bet ${formatChipStack(player.bet, bigBlind)}`;\n  const parts = [stack, bet, player.folded === true ? 'Folded' : undefined].filter(\n    (part): part is string => part !== undefined,\n  );\n\n  return parts.length === 0 ? undefined : parts.join(' · ');\n}\n\n/*** Formats chips as big blinds when a positive blind is known, otherwise as an amount. */\nfunction formatChipStack(amount: number, bigBlind: number | undefined): string {\n  if (bigBlind !== undefined && bigBlind > 0) {\n    return `${formatAmount(amount / bigBlind)} BB`;\n  }\n\n  return `${formatAmount(amount)} chips`;\n}\n\n/*** Formats a numeric poker amount consistently across native and web runtimes. */\nfunction formatAmount(amount: number): string {\n  return new Intl.NumberFormat('en-US', { maximumFractionDigits: 2 }).format(amount);\n}\n\n/*** Summarizes the reconstructed table for assistive technologies. */\nfunction createPokerAccessibilityLabel(\n  tableSize: PokerTrainingTableSize,\n  heroPosition: string | undefined,\n  task: PokerTrainingTaskTableData,\n): string {\n  const parts = [`${tableSize === '6max' ? 'Six' : 'Nine'}-player poker table`];\n  if (heroPosition !== undefined) parts.push(`Hero ${heroPosition}`);\n  if (task.pot !== undefined) parts.push(`Pot ${formatAmount(task.pot)}`);\n  if (task.blinds !== undefined) {\n    parts.push(`Blinds ${formatAmount(task.blinds.small)} / ${formatAmount(task.blinds.big)}`);\n  }\n\n  return `${parts.join('. ')}.`;\n}\n"]}

package/dist/features/tabletop/utils/createTabletopColorScheme.d.ts

@@ -0,0 +1,36 @@
+import type { TabletopColorOverrides, TabletopColorScheme } from '../../../types/tabletop';
+interface TabletopColorThemeShape {
+    semantics: {
+        action: {
+            primary: {
+                base: string;
+                softBg: string;
+            };
+        };
+        content: {
+            default: string;
+            muted: string;
+        };
+        neutral: {
+            border: string;
+            divider: string;
+            surface: string;
+            surfaceHover: string;
+        };
+        warning: {
+            base: string;
+            softBg: string;
+        };
+    };
+}
+/***
+ * Creates the theme-derived color palette used by tabletop primitives.
+ *
+ * Use `createTabletopColorScheme` when custom components need to align with the
+ * same card, table, seat, token, and contrast-aware foreground colors as the
+ * built-in tabletop components.
+ *
+ */
+export declare function createTabletopColorScheme(theme: TabletopColorThemeShape, overrides?: TabletopColorOverrides): TabletopColorScheme;
+export {};
+//# sourceMappingURL=createTabletopColorScheme.d.ts.map

package/dist/features/tabletop/utils/createTabletopColorScheme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createTabletopColorScheme.d.ts","sourceRoot":"","sources":["../../../../src/features/tabletop/utils/createTabletopColorScheme.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAE3F,UAAU,uBAAuB;IAC/B,SAAS,EAAE;QACT,MAAM,EAAE;YACN,OAAO,EAAE;gBACP,IAAI,EAAE,MAAM,CAAC;gBACb,MAAM,EAAE,MAAM,CAAC;aAChB,CAAC;SACH,CAAC;QACF,OAAO,EAAE;YACP,OAAO,EAAE,MAAM,CAAC;YAChB,KAAK,EAAE,MAAM,CAAC;SACf,CAAC;QACF,OAAO,EAAE;YACP,MAAM,EAAE,MAAM,CAAC;YACf,OAAO,EAAE,MAAM,CAAC;YAChB,OAAO,EAAE,MAAM,CAAC;YAChB,YAAY,EAAE,MAAM,CAAC;SACtB,CAAC;QACF,OAAO,EAAE;YACP,IAAI,EAAE,MAAM,CAAC;YACb,MAAM,EAAE,MAAM,CAAC;SAChB,CAAC;KACH,CAAC;CACH;AAUD;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,uBAAuB,EAC9B,SAAS,GAAE,sBAA2B,GACrC,mBAAmB,CAgErB"}

package/dist/features/tabletop/utils/createTabletopColorScheme.js

@@ -0,0 +1,144 @@
+import { getReadableForeground, parseHexColor as parseCanonicalHexColor, } from '@ankhorage/color-theory';
+const MINIMUM_READABLE_CONTRAST = 4.5;
+/***
+ * Creates the theme-derived color palette used by tabletop primitives.
+ *
+ * Use `createTabletopColorScheme` when custom components need to align with the
+ * same card, table, seat, token, and contrast-aware foreground colors as the
+ * built-in tabletop components.
+ *
+ */
+export function createTabletopColorScheme(theme, overrides = {}) {
+    const cardSurface = overrides.cardSurface ?? theme.semantics.neutral.surface;
+    const seatSurface = overrides.seatSurface ?? theme.semantics.neutral.surface;
+    const tableFelt = overrides.tableFelt ?? theme.semantics.action.primary.softBg;
+    const tokenSurface = overrides.tokenSurface ?? theme.semantics.warning.softBg;
+    const cardText = overrides.cardText ??
+        resolveReadableTextColor(cardSurface, theme.semantics.content.default, theme.semantics.content.muted);
+    const seatText = overrides.seatText ??
+        resolveReadableTextColor(seatSurface, theme.semantics.content.default, theme.semantics.content.muted);
+    const tableText = overrides.tableText ??
+        resolveReadableTextColor(tableFelt, theme.semantics.content.default, theme.semantics.content.muted);
+    const tokenText = overrides.tokenText ??
+        resolveReadableTextColor(tokenSurface, theme.semantics.content.default, theme.semantics.content.muted);
+    return {
+        cardBack: overrides.cardBack ?? theme.semantics.warning.base,
+        cardBackBorder: overrides.cardBackBorder ?? theme.semantics.neutral.border,
+        cardBorder: overrides.cardBorder ?? theme.semantics.neutral.border,
+        cardSurface,
+        cardText,
+        mutedText: overrides.mutedText ??
+            resolveReadableTextColor(cardSurface, theme.semantics.content.muted, cardText),
+        redSuitText: overrides.redSuitText ??
+            resolveReadableTextColor(cardSurface, theme.semantics.warning.base, cardText),
+        seatBorder: overrides.seatBorder ?? theme.semantics.neutral.divider,
+        seatMutedText: overrides.seatMutedText ??
+            resolveReadableTextColor(seatSurface, theme.semantics.content.muted, seatText),
+        seatSelectedBorder: overrides.seatSelectedBorder ?? theme.semantics.action.primary.base,
+        seatSurface,
+        seatText,
+        tableBorder: overrides.tableBorder ?? theme.semantics.warning.base,
+        tableFelt,
+        tableInnerBorder: overrides.tableInnerBorder ?? theme.semantics.neutral.divider,
+        tableMutedText: overrides.tableMutedText ??
+            resolveReadableTextColor(tableFelt, theme.semantics.content.muted, tableText),
+        tableText,
+        tokenSurface,
+        tokenText,
+    };
+}
+/*** Chooses the most legible supplied foreground for a themed surface. */
+function resolveReadableTextColor(background, preferred, fallback) {
+    const preferredContrast = getContrastRatio(background, preferred);
+    if (preferredContrast !== null && preferredContrast >= MINIMUM_READABLE_CONTRAST) {
+        return preferred;
+    }
+    const parsedBackground = parseHexColor(background);
+    const normalizedBackground = parsedBackground === null ? null : parseCanonicalHexColor(toHexColor(parsedBackground));
+    const strongestForeground = normalizedBackground === null
+        ? undefined
+        : getReadableForeground(normalizedBackground).foreground;
+    const candidates = uniqueColors([
+        preferred,
+        fallback,
+        ...(strongestForeground === undefined ? [] : [strongestForeground]),
+    ]);
+    const [readableCandidate] = candidates
+        .map((candidate) => ({ candidate, contrast: getContrastRatio(background, candidate) }))
+        .filter((entry) => entry.contrast !== null)
+        .sort((left, right) => right.contrast - left.contrast);
+    return readableCandidate?.candidate ?? preferred;
+}
+/*** Converts a parsed color to Color Theory's canonical six-digit input. */
+function toHexColor(color) {
+    return `#${[color.red, color.green, color.blue].map((channel) => channel.toString(16).padStart(2, '0')).join('')}`;
+}
+/*** Removes duplicate contrast candidates without changing their order. */
+function uniqueColors(colors) {
+    return [...new Set(colors)];
+}
+/*** Measures contrast when both colors can be parsed as hex. */
+function getContrastRatio(background, foreground) {
+    const backgroundColor = parseHexColor(background);
+    const foregroundColor = parseHexColor(foreground);
+    if (backgroundColor === null || foregroundColor === null)
+        return null;
+    const backgroundLuminance = getRelativeLuminance(backgroundColor);
+    const foregroundLuminance = getRelativeLuminance(foregroundColor);
+    const lighter = Math.max(backgroundLuminance, foregroundLuminance);
+    const darker = Math.min(backgroundLuminance, foregroundLuminance);
+    return (lighter + 0.05) / (darker + 0.05);
+}
+/*** Parses the hex colors supported by the tabletop palette. */
+function parseHexColor(color) {
+    const value = color.trim();
+    const hex = value.startsWith('#') ? value.slice(1) : '';
+    if (!isSupportedHexLength(hex) || !isHexColorValue(hex))
+        return null;
+    if (hex.length === 3) {
+        const red = hex.slice(0, 1);
+        const green = hex.slice(1, 2);
+        const blue = hex.slice(2, 3);
+        return {
+            red: parseInt(red + red, 16),
+            green: parseInt(green + green, 16),
+            blue: parseInt(blue + blue, 16),
+        };
+    }
+    return {
+        red: parseInt(hex.slice(0, 2), 16),
+        green: parseInt(hex.slice(2, 4), 16),
+        blue: parseInt(hex.slice(4, 6), 16),
+    };
+}
+/*** Checks the supported short, full, and alpha hex lengths. */
+function isSupportedHexLength(hex) {
+    return hex.length === 3 || hex.length === 6 || hex.length === 8;
+}
+/*** Rejects non-hexadecimal color digits. */
+function isHexColorValue(hex) {
+    return [...hex].every((character) => isHexCharacter(character));
+}
+/*** Checks whether a character is a hexadecimal digit. */
+function isHexCharacter(character) {
+    const code = character.charCodeAt(0);
+    const isDigit = code >= 48 && code <= 57;
+    const isUpperHex = code >= 65 && code <= 70;
+    const isLowerHex = code >= 97 && code <= 102;
+    return isDigit || isUpperHex || isLowerHex;
+}
+/*** Computes relative luminance for one RGB color. */
+function getRelativeLuminance(color) {
+    const red = normalizeColorChannel(color.red);
+    const green = normalizeColorChannel(color.green);
+    const blue = normalizeColorChannel(color.blue);
+    return 0.2126 * red + 0.7152 * green + 0.0722 * blue;
+}
+/*** Converts an RGB channel into linear light. */
+function normalizeColorChannel(value) {
+    const normalized = value / 255;
+    if (normalized <= 0.03928)
+        return normalized / 12.92;
+    return ((normalized + 0.055) / 1.055) ** 2.4;
+}
+//# sourceMappingURL=createTabletopColorScheme.js.map

package/dist/features/tabletop/utils/createTabletopColorScheme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createTabletopColorScheme.js","sourceRoot":"","sources":["../../../../src/features/tabletop/utils/createTabletopColorScheme.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  getReadableForeground,\n  parseHexColor as parseCanonicalHexColor,\n} from '@ankhorage/color-theory';\n\nimport type { TabletopColorOverrides, TabletopColorScheme } from '../../../types/tabletop';\n\ninterface TabletopColorThemeShape {\n  semantics: {\n    action: {\n      primary: {\n        base: string;\n        softBg: string;\n      };\n    };\n    content: {\n      default: string;\n      muted: string;\n    };\n    neutral: {\n      border: string;\n      divider: string;\n      surface: string;\n      surfaceHover: string;\n    };\n    warning: {\n      base: string;\n      softBg: string;\n    };\n  };\n}\n\ninterface RgbColor {\n  readonly red: number;\n  readonly green: number;\n  readonly blue: number;\n}\n\nconst MINIMUM_READABLE_CONTRAST = 4.5;\n\n/***\n * Creates the theme-derived color palette used by tabletop primitives.\n *\n * Use `createTabletopColorScheme` when custom components need to align with the\n * same card, table, seat, token, and contrast-aware foreground colors as the\n * built-in tabletop components.\n *\n */\nexport function createTabletopColorScheme(\n  theme: TabletopColorThemeShape,\n  overrides: TabletopColorOverrides = {},\n): TabletopColorScheme {\n  const cardSurface = overrides.cardSurface ?? theme.semantics.neutral.surface;\n  const seatSurface = overrides.seatSurface ?? theme.semantics.neutral.surface;\n  const tableFelt = overrides.tableFelt ?? theme.semantics.action.primary.softBg;\n  const tokenSurface = overrides.tokenSurface ?? theme.semantics.warning.softBg;\n\n  const cardText =\n    overrides.cardText ??\n    resolveReadableTextColor(\n      cardSurface,\n      theme.semantics.content.default,\n      theme.semantics.content.muted,\n    );\n  const seatText =\n    overrides.seatText ??\n    resolveReadableTextColor(\n      seatSurface,\n      theme.semantics.content.default,\n      theme.semantics.content.muted,\n    );\n  const tableText =\n    overrides.tableText ??\n    resolveReadableTextColor(\n      tableFelt,\n      theme.semantics.content.default,\n      theme.semantics.content.muted,\n    );\n  const tokenText =\n    overrides.tokenText ??\n    resolveReadableTextColor(\n      tokenSurface,\n      theme.semantics.content.default,\n      theme.semantics.content.muted,\n    );\n\n  return {\n    cardBack: overrides.cardBack ?? theme.semantics.warning.base,\n    cardBackBorder: overrides.cardBackBorder ?? theme.semantics.neutral.border,\n    cardBorder: overrides.cardBorder ?? theme.semantics.neutral.border,\n    cardSurface,\n    cardText,\n    mutedText:\n      overrides.mutedText ??\n      resolveReadableTextColor(cardSurface, theme.semantics.content.muted, cardText),\n    redSuitText:\n      overrides.redSuitText ??\n      resolveReadableTextColor(cardSurface, theme.semantics.warning.base, cardText),\n    seatBorder: overrides.seatBorder ?? theme.semantics.neutral.divider,\n    seatMutedText:\n      overrides.seatMutedText ??\n      resolveReadableTextColor(seatSurface, theme.semantics.content.muted, seatText),\n    seatSelectedBorder: overrides.seatSelectedBorder ?? theme.semantics.action.primary.base,\n    seatSurface,\n    seatText,\n    tableBorder: overrides.tableBorder ?? theme.semantics.warning.base,\n    tableFelt,\n    tableInnerBorder: overrides.tableInnerBorder ?? theme.semantics.neutral.divider,\n    tableMutedText:\n      overrides.tableMutedText ??\n      resolveReadableTextColor(tableFelt, theme.semantics.content.muted, tableText),\n    tableText,\n    tokenSurface,\n    tokenText,\n  };\n}\n\n/*** Chooses the most legible supplied foreground for a themed surface. */\nfunction resolveReadableTextColor(background: string, preferred: string, fallback: string): string {\n  const preferredContrast = getContrastRatio(background, preferred);\n  if (preferredContrast !== null && preferredContrast >= MINIMUM_READABLE_CONTRAST) {\n    return preferred;\n  }\n\n  const parsedBackground = parseHexColor(background);\n  const normalizedBackground =\n    parsedBackground === null ? null : parseCanonicalHexColor(toHexColor(parsedBackground));\n  const strongestForeground =\n    normalizedBackground === null\n      ? undefined\n      : getReadableForeground(normalizedBackground).foreground;\n  const candidates = uniqueColors([\n    preferred,\n    fallback,\n    ...(strongestForeground === undefined ? [] : [strongestForeground]),\n  ]);\n  const [readableCandidate] = candidates\n    .map((candidate) => ({ candidate, contrast: getContrastRatio(background, candidate) }))\n    .filter(\n      (entry): entry is { readonly candidate: string; readonly contrast: number } =>\n        entry.contrast !== null,\n    )\n    .sort((left, right) => right.contrast - left.contrast);\n\n  return readableCandidate?.candidate ?? preferred;\n}\n\n/*** Converts a parsed color to Color Theory's canonical six-digit input. */\nfunction toHexColor(color: RgbColor): string {\n  return `#${[color.red, color.green, color.blue].map((channel) => channel.toString(16).padStart(2, '0')).join('')}`;\n}\n\n/*** Removes duplicate contrast candidates without changing their order. */\nfunction uniqueColors(colors: readonly string[]): string[] {\n  return [...new Set(colors)];\n}\n\n/*** Measures contrast when both colors can be parsed as hex. */\nfunction getContrastRatio(background: string, foreground: string): number | null {\n  const backgroundColor = parseHexColor(background);\n  const foregroundColor = parseHexColor(foreground);\n\n  if (backgroundColor === null || foregroundColor === null) return null;\n\n  const backgroundLuminance = getRelativeLuminance(backgroundColor);\n  const foregroundLuminance = getRelativeLuminance(foregroundColor);\n  const lighter = Math.max(backgroundLuminance, foregroundLuminance);\n  const darker = Math.min(backgroundLuminance, foregroundLuminance);\n\n  return (lighter + 0.05) / (darker + 0.05);\n}\n\n/*** Parses the hex colors supported by the tabletop palette. */\nfunction parseHexColor(color: string): RgbColor | null {\n  const value = color.trim();\n  const hex = value.startsWith('#') ? value.slice(1) : '';\n  if (!isSupportedHexLength(hex) || !isHexColorValue(hex)) return null;\n\n  if (hex.length === 3) {\n    const red = hex.slice(0, 1);\n    const green = hex.slice(1, 2);\n    const blue = hex.slice(2, 3);\n\n    return {\n      red: parseInt(red + red, 16),\n      green: parseInt(green + green, 16),\n      blue: parseInt(blue + blue, 16),\n    };\n  }\n\n  return {\n    red: parseInt(hex.slice(0, 2), 16),\n    green: parseInt(hex.slice(2, 4), 16),\n    blue: parseInt(hex.slice(4, 6), 16),\n  };\n}\n\n/*** Checks the supported short, full, and alpha hex lengths. */\nfunction isSupportedHexLength(hex: string): boolean {\n  return hex.length === 3 || hex.length === 6 || hex.length === 8;\n}\n\n/*** Rejects non-hexadecimal color digits. */\nfunction isHexColorValue(hex: string): boolean {\n  return [...hex].every((character) => isHexCharacter(character));\n}\n\n/*** Checks whether a character is a hexadecimal digit. */\nfunction isHexCharacter(character: string): boolean {\n  const code = character.charCodeAt(0);\n  const isDigit = code >= 48 && code <= 57;\n  const isUpperHex = code >= 65 && code <= 70;\n  const isLowerHex = code >= 97 && code <= 102;\n\n  return isDigit || isUpperHex || isLowerHex;\n}\n\n/*** Computes relative luminance for one RGB color. */\nfunction getRelativeLuminance(color: RgbColor): number {\n  const red = normalizeColorChannel(color.red);\n  const green = normalizeColorChannel(color.green);\n  const blue = normalizeColorChannel(color.blue);\n\n  return 0.2126 * red + 0.7152 * green + 0.0722 * blue;\n}\n\n/*** Converts an RGB channel into linear light. */\nfunction normalizeColorChannel(value: number): number {\n  const normalized = value / 255;\n  if (normalized <= 0.03928) return normalized / 12.92;\n  return ((normalized + 0.055) / 1.055) ** 2.4;\n}\n"]}

package/dist/features/tabletop/utils/createTabletopGameSeats.d.ts

@@ -0,0 +1,13 @@
+import type { CreateTabletopGameSeatsInput, TabletopSeatState } from '../../../types/tabletop';
+/***
+ * Joins an ordered game layout with the participant states currently present in a scene.
+ *
+ * Missing participants retain their seat definition and receive the configured fallback state,
+ * which lets card games represent folded, eliminated, disconnected, or otherwise inactive seats
+ * without embedding those game rules in the tabletop renderer.
+ *
+ * Accepts ordered seats, participant overrides, and the fallback for missing participants, then
+ * returns normalized tabletop seats in the same order as the supplied seat definitions.
+ */
+export declare function createTabletopGameSeats({ seats, participants, missingParticipantState, }: CreateTabletopGameSeatsInput): readonly TabletopSeatState[];
+//# sourceMappingURL=createTabletopGameSeats.d.ts.map

package/dist/features/tabletop/utils/createTabletopGameSeats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createTabletopGameSeats.d.ts","sourceRoot":"","sources":["../../../../src/features/tabletop/utils/createTabletopGameSeats.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE/F;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,KAAK,EACL,YAAY,EACZ,uBAAyD,GAC1D,EAAE,4BAA4B,GAAG,SAAS,iBAAiB,EAAE,CAc7D"}

package/dist/features/tabletop/utils/createTabletopGameSeats.js

@@ -0,0 +1,22 @@
+/***
+ * Joins an ordered game layout with the participant states currently present in a scene.
+ *
+ * Missing participants retain their seat definition and receive the configured fallback state,
+ * which lets card games represent folded, eliminated, disconnected, or otherwise inactive seats
+ * without embedding those game rules in the tabletop renderer.
+ *
+ * Accepts ordered seats, participant overrides, and the fallback for missing participants, then
+ * returns normalized tabletop seats in the same order as the supplied seat definitions.
+ */
+export function createTabletopGameSeats({ seats, participants, missingParticipantState = { disabled: true, muted: true }, }) {
+    const participantsBySeat = new Map(participants.map((participant) => [participant.seatId, participant]));
+    return seats.map((seat) => {
+        const participant = participantsBySeat.get(seat.id);
+        return {
+            id: seat.id,
+            ...seat.defaultState,
+            ...(participant === undefined ? missingParticipantState : participant.state),
+        };
+    });
+}
+//# sourceMappingURL=createTabletopGameSeats.js.map

package/dist/features/tabletop/utils/createTabletopGameSeats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createTabletopGameSeats.js","sourceRoot":"","sources":["../../../../src/features/tabletop/utils/createTabletopGameSeats.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,UAAU,uBAAuB,CAAC,EACtC,KAAK,EACL,YAAY,EACZ,uBAAuB,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,GAC5B;IAC7B,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAChC,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,MAAM,EAAE,WAAW,CAAU,CAAC,CAC9E,CAAC;IAEF,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACxB,MAAM,WAAW,GAAG,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEpD,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,GAAG,IAAI,CAAC,YAAY;YACpB,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC;SAC7E,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { CreateTabletopGameSeatsInput, TabletopSeatState } from '../../../types/tabletop';\n\n/***\n * Joins an ordered game layout with the participant states currently present in a scene.\n *\n * Missing participants retain their seat definition and receive the configured fallback state,\n * which lets card games represent folded, eliminated, disconnected, or otherwise inactive seats\n * without embedding those game rules in the tabletop renderer.\n *\n * Accepts ordered seats, participant overrides, and the fallback for missing participants, then\n * returns normalized tabletop seats in the same order as the supplied seat definitions.\n */\nexport function createTabletopGameSeats({\n  seats,\n  participants,\n  missingParticipantState = { disabled: true, muted: true },\n}: CreateTabletopGameSeatsInput): readonly TabletopSeatState[] {\n  const participantsBySeat = new Map(\n    participants.map((participant) => [participant.seatId, participant] as const),\n  );\n\n  return seats.map((seat) => {\n    const participant = participantsBySeat.get(seat.id);\n\n    return {\n      id: seat.id,\n      ...seat.defaultState,\n      ...(participant === undefined ? missingParticipantState : participant.state),\n    };\n  });\n}\n"]}

package/dist/features/tabletop/utils/getPlayingCardLabel.d.ts

@@ -0,0 +1,4 @@
+import type { PlayingCardValue } from '../../../types/tabletop';
+/*** Gives a face-up card a spoken rank and suit. */
+export declare function getPlayingCardLabel(card: PlayingCardValue): string;
+//# sourceMappingURL=getPlayingCardLabel.d.ts.map

package/dist/features/tabletop/utils/getPlayingCardLabel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getPlayingCardLabel.d.ts","sourceRoot":"","sources":["../../../../src/features/tabletop/utils/getPlayingCardLabel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAIhE,oDAAoD;AACpD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAElE"}

package/dist/features/tabletop/utils/getPlayingCardLabel.js

@@ -0,0 +1,6 @@
+const rankLabels = { A: 'ace', J: 'jack', K: 'king', Q: 'queen' };
+/*** Gives a face-up card a spoken rank and suit. */
+export function getPlayingCardLabel(card) {
+    return `${rankLabels[card.rank] ?? card.rank} of ${card.suit}`;
+}
+//# sourceMappingURL=getPlayingCardLabel.js.map

package/dist/features/tabletop/utils/getPlayingCardLabel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getPlayingCardLabel.js","sourceRoot":"","sources":["../../../../src/features/tabletop/utils/getPlayingCardLabel.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAAqC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC;AAEpG,oDAAoD;AACpD,MAAM,UAAU,mBAAmB,CAAC,IAAsB;IACxD,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;AACjE,CAAC","sourcesContent":["import type { PlayingCardValue } from '../../../types/tabletop';\n\nconst rankLabels: Readonly<Record<string, string>> = { A: 'ace', J: 'jack', K: 'king', Q: 'queen' };\n\n/*** Gives a face-up card a spoken rank and suit. */\nexport function getPlayingCardLabel(card: PlayingCardValue): string {\n  return `${rankLabels[card.rank] ?? card.rank} of ${card.suit}`;\n}\n"]}

package/dist/features/tabletop/utils/getTabletopCardDimensions.d.ts

@@ -0,0 +1,12 @@
+import type { TabletopCardSize } from '../../../types/tabletop';
+interface TabletopCardDimensions {
+    readonly width: number;
+    readonly height: number;
+    readonly radius: number;
+    readonly rankFontSize: number;
+    readonly suitFontSize: number;
+}
+/*** Returns the published dimensions for a tabletop card size. */
+export declare function getTabletopCardDimensions(size: TabletopCardSize): TabletopCardDimensions;
+export {};
+//# sourceMappingURL=getTabletopCardDimensions.d.ts.map

package/dist/features/tabletop/utils/getTabletopCardDimensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getTabletopCardDimensions.d.ts","sourceRoot":"","sources":["../../../../src/features/tabletop/utils/getTabletopCardDimensions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,UAAU,sBAAsB;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AA0BD,kEAAkE;AAClE,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,gBAAgB,GAAG,sBAAsB,CASxF"}

package/dist/features/tabletop/utils/getTabletopCardDimensions.js

@@ -0,0 +1,35 @@
+const cardDimensions = {
+    large: {
+        width: 56,
+        height: 80,
+        radius: 8,
+        rankFontSize: 20,
+        suitFontSize: 16,
+    },
+    medium: {
+        width: 40,
+        height: 56,
+        radius: 6,
+        rankFontSize: 15,
+        suitFontSize: 12,
+    },
+    small: {
+        width: 28,
+        height: 40,
+        radius: 5,
+        rankFontSize: 11,
+        suitFontSize: 9,
+    },
+};
+/*** Returns the published dimensions for a tabletop card size. */
+export function getTabletopCardDimensions(size) {
+    switch (size) {
+        case 'small':
+            return cardDimensions.small;
+        case 'large':
+            return cardDimensions.large;
+        case 'medium':
+            return cardDimensions.medium;
+    }
+}
+//# sourceMappingURL=getTabletopCardDimensions.js.map

package/dist/features/tabletop/utils/getTabletopCardDimensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getTabletopCardDimensions.js","sourceRoot":"","sources":["../../../../src/features/tabletop/utils/getTabletopCardDimensions.ts"],"names":[],"mappings":"AAUA,MAAM,cAAc,GAA+D;IACjF,KAAK,EAAE;QACL,KAAK,EAAE,EAAE;QACT,MAAM,EAAE,EAAE;QACV,MAAM,EAAE,CAAC;QACT,YAAY,EAAE,EAAE;QAChB,YAAY,EAAE,EAAE;KACjB;IACD,MAAM,EAAE;QACN,KAAK,EAAE,EAAE;QACT,MAAM,EAAE,EAAE;QACV,MAAM,EAAE,CAAC;QACT,YAAY,EAAE,EAAE;QAChB,YAAY,EAAE,EAAE;KACjB;IACD,KAAK,EAAE;QACL,KAAK,EAAE,EAAE;QACT,MAAM,EAAE,EAAE;QACV,MAAM,EAAE,CAAC;QACT,YAAY,EAAE,EAAE;QAChB,YAAY,EAAE,CAAC;KAChB;CACF,CAAC;AAEF,kEAAkE;AAClE,MAAM,UAAU,yBAAyB,CAAC,IAAsB;IAC9D,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,OAAO;YACV,OAAO,cAAc,CAAC,KAAK,CAAC;QAC9B,KAAK,OAAO;YACV,OAAO,cAAc,CAAC,KAAK,CAAC;QAC9B,KAAK,QAAQ;YACX,OAAO,cAAc,CAAC,MAAM,CAAC;IACjC,CAAC;AACH,CAAC","sourcesContent":["import type { TabletopCardSize } from '../../../types/tabletop';\n\ninterface TabletopCardDimensions {\n  readonly width: number;\n  readonly height: number;\n  readonly radius: number;\n  readonly rankFontSize: number;\n  readonly suitFontSize: number;\n}\n\nconst cardDimensions: Readonly<Record<TabletopCardSize, TabletopCardDimensions>> = {\n  large: {\n    width: 56,\n    height: 80,\n    radius: 8,\n    rankFontSize: 20,\n    suitFontSize: 16,\n  },\n  medium: {\n    width: 40,\n    height: 56,\n    radius: 6,\n    rankFontSize: 15,\n    suitFontSize: 12,\n  },\n  small: {\n    width: 28,\n    height: 40,\n    radius: 5,\n    rankFontSize: 11,\n    suitFontSize: 9,\n  },\n};\n\n/*** Returns the published dimensions for a tabletop card size. */\nexport function getTabletopCardDimensions(size: TabletopCardSize): TabletopCardDimensions {\n  switch (size) {\n    case 'small':\n      return cardDimensions.small;\n    case 'large':\n      return cardDimensions.large;\n    case 'medium':\n      return cardDimensions.medium;\n  }\n}\n"]}

package/dist/features/tabletop/utils/getTabletopSeatPosition.d.ts

@@ -0,0 +1,9 @@
+type TabletopSeatPositionValue = `${number}%`;
+interface TabletopSeatPosition {
+    readonly top: TabletopSeatPositionValue;
+    readonly left: TabletopSeatPositionValue;
+}
+/*** Returns a seat's canonical position with the hero at the bottom. */
+export declare function getTabletopSeatPosition(index: number, count: number): TabletopSeatPosition;
+export {};
+//# sourceMappingURL=getTabletopSeatPosition.d.ts.map

package/dist/features/tabletop/utils/getTabletopSeatPosition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getTabletopSeatPosition.d.ts","sourceRoot":"","sources":["../../../../src/features/tabletop/utils/getTabletopSeatPosition.ts"],"names":[],"mappings":"AAEA,KAAK,yBAAyB,GAAG,GAAG,MAAM,GAAG,CAAC;AAE9C,UAAU,oBAAoB;IAC5B,QAAQ,CAAC,GAAG,EAAE,yBAAyB,CAAC;IACxC,QAAQ,CAAC,IAAI,EAAE,yBAAyB,CAAC;CAC1C;AAsFD,wEAAwE;AACxE,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,oBAAoB,CAK1F"}

package/dist/features/tabletop/utils/getTabletopSeatPosition.js

@@ -0,0 +1,88 @@
+const fallbackSeatPosition = { top: '82%', left: '50%' };
+const seatPositions = {
+    2: [fallbackSeatPosition, { top: '18%', left: '50%' }],
+    3: [fallbackSeatPosition, { top: '28%', left: '18%' }, { top: '28%', left: '82%' }],
+    4: [
+        fallbackSeatPosition,
+        { top: '50%', left: '12%' },
+        { top: '18%', left: '50%' },
+        { top: '50%', left: '88%' },
+    ],
+    5: [
+        { top: '84%', left: '50%' },
+        { top: '62%', left: '12%' },
+        { top: '18%', left: '24%' },
+        { top: '18%', left: '76%' },
+        { top: '62%', left: '88%' },
+    ],
+    6: [
+        { top: '84%', left: '50%' },
+        { top: '68%', left: '16%' },
+        { top: '26%', left: '16%' },
+        { top: '16%', left: '50%' },
+        { top: '26%', left: '84%' },
+        { top: '68%', left: '84%' },
+    ],
+    7: [
+        { top: '86%', left: '50%' },
+        { top: '70%', left: '14%' },
+        { top: '34%', left: '10%' },
+        { top: '14%', left: '34%' },
+        { top: '14%', left: '66%' },
+        { top: '34%', left: '90%' },
+        { top: '70%', left: '86%' },
+    ],
+    8: [
+        { top: '86%', left: '50%' },
+        { top: '72%', left: '16%' },
+        { top: '50%', left: '8%' },
+        { top: '20%', left: '20%' },
+        { top: '14%', left: '50%' },
+        { top: '20%', left: '80%' },
+        { top: '50%', left: '92%' },
+        { top: '72%', left: '84%' },
+    ],
+    9: [
+        { top: '88%', left: '50%' },
+        { top: '78%', left: '12%' },
+        { top: '50%', left: '4%' },
+        { top: '18%', left: '10%' },
+        { top: '8%', left: '28%' },
+        { top: '8%', left: '50%' },
+        { top: '8%', left: '72%' },
+        { top: '18%', left: '90%' },
+        { top: '50%', left: '96%' },
+    ],
+    10: [
+        { top: '88%', left: '50%' },
+        { top: '80%', left: '20%' },
+        { top: '58%', left: '6%' },
+        { top: '30%', left: '8%' },
+        { top: '10%', left: '30%' },
+        { top: '8%', left: '50%' },
+        { top: '10%', left: '70%' },
+        { top: '30%', left: '92%' },
+        { top: '58%', left: '94%' },
+        { top: '80%', left: '80%' },
+    ],
+};
+/*** Clamps the requested tabletop seat count to a supported ring. */
+function normalizeTabletopSeatCount(count) {
+    const rounded = Math.round(count);
+    if (rounded <= 2)
+        return 2;
+    if (rounded >= 10)
+        return 10;
+    return rounded;
+}
+/*** Returns the canonical seat positions for a ring size. */
+function getTabletopSeatPositions(count) {
+    return seatPositions[normalizeTabletopSeatCount(count)];
+}
+/*** Returns a seat's canonical position with the hero at the bottom. */
+export function getTabletopSeatPosition(index, count) {
+    const positions = getTabletopSeatPositions(count);
+    const position = positions[index % positions.length];
+    return position ?? fallbackSeatPosition;
+}
+//# sourceMappingURL=getTabletopSeatPosition.js.map

package/dist/features/tabletop/utils/getTabletopSeatPosition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getTabletopSeatPosition.js","sourceRoot":"","sources":["../../../../src/features/tabletop/utils/getTabletopSeatPosition.ts"],"names":[],"mappings":"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","sourcesContent":["import type { TabletopSeatCount } from '../../../types/tabletop';\n\ntype TabletopSeatPositionValue = `${number}%`;\n\ninterface TabletopSeatPosition {\n  readonly top: TabletopSeatPositionValue;\n  readonly left: TabletopSeatPositionValue;\n}\n\nconst fallbackSeatPosition: TabletopSeatPosition = { top: '82%', left: '50%' };\n\nconst seatPositions: Readonly<Record<TabletopSeatCount, readonly TabletopSeatPosition[]>> = {\n  2: [fallbackSeatPosition, { top: '18%', left: '50%' }],\n  3: [fallbackSeatPosition, { top: '28%', left: '18%' }, { top: '28%', left: '82%' }],\n  4: [\n    fallbackSeatPosition,\n    { top: '50%', left: '12%' },\n    { top: '18%', left: '50%' },\n    { top: '50%', left: '88%' },\n  ],\n  5: [\n    { top: '84%', left: '50%' },\n    { top: '62%', left: '12%' },\n    { top: '18%', left: '24%' },\n    { top: '18%', left: '76%' },\n    { top: '62%', left: '88%' },\n  ],\n  6: [\n    { top: '84%', left: '50%' },\n    { top: '68%', left: '16%' },\n    { top: '26%', left: '16%' },\n    { top: '16%', left: '50%' },\n    { top: '26%', left: '84%' },\n    { top: '68%', left: '84%' },\n  ],\n  7: [\n    { top: '86%', left: '50%' },\n    { top: '70%', left: '14%' },\n    { top: '34%', left: '10%' },\n    { top: '14%', left: '34%' },\n    { top: '14%', left: '66%' },\n    { top: '34%', left: '90%' },\n    { top: '70%', left: '86%' },\n  ],\n  8: [\n    { top: '86%', left: '50%' },\n    { top: '72%', left: '16%' },\n    { top: '50%', left: '8%' },\n    { top: '20%', left: '20%' },\n    { top: '14%', left: '50%' },\n    { top: '20%', left: '80%' },\n    { top: '50%', left: '92%' },\n    { top: '72%', left: '84%' },\n  ],\n  9: [\n    { top: '88%', left: '50%' },\n    { top: '78%', left: '12%' },\n    { top: '50%', left: '4%' },\n    { top: '18%', left: '10%' },\n    { top: '8%', left: '28%' },\n    { top: '8%', left: '50%' },\n    { top: '8%', left: '72%' },\n    { top: '18%', left: '90%' },\n    { top: '50%', left: '96%' },\n  ],\n  10: [\n    { top: '88%', left: '50%' },\n    { top: '80%', left: '20%' },\n    { top: '58%', left: '6%' },\n    { top: '30%', left: '8%' },\n    { top: '10%', left: '30%' },\n    { top: '8%', left: '50%' },\n    { top: '10%', left: '70%' },\n    { top: '30%', left: '92%' },\n    { top: '58%', left: '94%' },\n    { top: '80%', left: '80%' },\n  ],\n};\n\n/*** Clamps the requested tabletop seat count to a supported ring. */\nfunction normalizeTabletopSeatCount(count: number): TabletopSeatCount {\n  const rounded = Math.round(count);\n  if (rounded <= 2) return 2;\n  if (rounded >= 10) return 10;\n\n  return rounded as TabletopSeatCount;\n}\n\n/*** Returns the canonical seat positions for a ring size. */\nfunction getTabletopSeatPositions(count: number): readonly TabletopSeatPosition[] {\n  return seatPositions[normalizeTabletopSeatCount(count)];\n}\n\n/*** Returns a seat's canonical position with the hero at the bottom. */\nexport function getTabletopSeatPosition(index: number, count: number): TabletopSeatPosition {\n  const positions = getTabletopSeatPositions(count);\n  const position = positions[index % positions.length];\n\n  return position ?? fallbackSeatPosition;\n}\n"]}