@pieai/swimmer-ui-kit 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,1781 @@
+import { ButtonHTMLAttributes } from 'react';
+import { ForwardRefExoticComponent } from 'react';
+import { HTMLAttributes } from 'react';
+import { InputHTMLAttributes } from 'react';
+import { ReactNode } from 'react';
+import { RefAttributes } from 'react';
+import { TextareaHTMLAttributes } from 'react';
+
+export declare const CLAY_ASSET_BASE_PATH: "/assets/game/ui/clay/phase03-clay-kit";
+
+export declare const CLAY_ASSET_SIZE_TOKENS: {
+    readonly iconSm: "var(--game-ui-asset-icon-sm)";
+    readonly iconMd: "var(--game-ui-asset-icon-md)";
+    readonly iconLg: "var(--game-ui-asset-icon-lg)";
+    readonly iconXl: "var(--game-ui-asset-icon-xl)";
+    readonly buttonSkinMinWidth: "var(--game-ui-asset-button-min-width)";
+    readonly cardFanWidth: "var(--game-ui-asset-card-fan-width)";
+    readonly stageTileMinHeight: "var(--game-ui-stage-tile-min-height)";
+    readonly terrainSwatchSize: "var(--game-ui-terrain-swatch-size)";
+    readonly terrainToolHitSize: "var(--game-ui-terrain-tool-hit-size)";
+    readonly buildRailCardSize: "var(--game-ui-build-rail-card-size)";
+    readonly brushNumberWidth: "var(--game-ui-brush-number-width)";
+};
+
+export declare const CLAY_ASSETS: {
+    buttons: {
+        primary: string;
+        blue: string;
+        brown: string;
+        green: string;
+        purple: string;
+        red: string;
+    };
+    panels: {
+        popup: string;
+        commonTitle: string;
+        language: string;
+    };
+    controls: {
+        switchOn: string;
+        switchOff: string;
+        slider: string;
+        tabSelected: string;
+        tabNormal: string;
+    };
+    icons: Record<ClayIconName, string>;
+    catalog: {
+        manifest: string;
+        sourceCatalog: string;
+        contactSheetCommon: string;
+        contactSheetComponents: string;
+        contactSheetFunction: string;
+    };
+};
+
+export declare const CLAY_COLOR_TOKENS: {
+    readonly ink: "#3b2d23";
+    readonly inkMuted: "#7b6652";
+    readonly parchment: "#fff8ec";
+    readonly parchmentDeep: "#f4e2c6";
+    readonly cream: "#f3e8d8";
+    readonly wood: "#6c4f38";
+    readonly woodDeep: "#3a2518";
+    readonly honey: "#f2b35c";
+    readonly orange: "#e8743b";
+    readonly teal: "#1d9a8b";
+    readonly green: "#4f9d6b";
+    readonly mint: "#7ee0b6";
+    readonly berry: "#9b6dd6";
+    readonly red: "#d85a45";
+    readonly sky: "#5ca6d8";
+    readonly shadow: "rgba(76, 52, 28, 0.24)";
+    readonly glass: "rgba(255, 248, 236, 0.82)";
+    readonly nightGlass: "rgba(31, 24, 18, 0.76)";
+};
+
+export declare const CLAY_ELEVATION_TOKENS: {
+    readonly button: "var(--game-ui-shadow-button)";
+    readonly panel: "var(--game-ui-shadow-panel)";
+    readonly modal: "var(--game-ui-shadow-modal)";
+    readonly inset: "var(--game-ui-shadow-inset)";
+    readonly stroke: "var(--game-ui-stroke)";
+};
+
+export declare const CLAY_GAME_SPRITE_NAMES: ClayGameSpriteName[];
+
+/**
+ * Decorative game-content sprites — sculpted clay objects from the same source
+ * pack that read as *game content* (loot, weapons, shields, potions, currency
+ * variants) rather than UI affordances. They are deliberately kept OUT of
+ * CLAY_ICON_VARIANTS so the semantic icon API stays a clean, product-agnostic UI
+ * vocabulary. Reach for these in reward popups, inventories, win screens, or
+ * decorative flourishes — never for buttons or toolbars. Game family only; these
+ * have no flat line equivalents.
+ */
+export declare const CLAY_GAME_SPRITES: {
+    anvil: string;
+    arrow: string;
+    bomb: string;
+    candle: string;
+    chicken: string;
+    giftBlue: string;
+    hammer: string;
+    horn: string;
+    horseshoe: string;
+    letter: string;
+    medalBronze: string;
+    medalSilver: string;
+    pickaxe: string;
+    potionPurple: string;
+    potionRed: string;
+    purpleGem: string;
+    shieldA: string;
+    shieldB: string;
+    shieldC: string;
+    shieldD: string;
+    skull: string;
+    soulGem: string;
+    swordA: string;
+    swordB: string;
+    talaria: string;
+    treasure: string;
+};
+
+export declare const CLAY_ICON_NAMES: ClayIconName[];
+
+export declare const CLAY_ICON_VARIANTS: {
+    ai: {
+        line: string;
+    };
+    alert: {
+        game: string;
+        line: string;
+    };
+    card: {
+        line: string;
+    };
+    chat: {
+        line: string;
+    };
+    check: {
+        line: string;
+    };
+    close: {
+        game: string;
+        line: string;
+    };
+    coin: {
+        game: string;
+        line: string;
+    };
+    compass: {
+        line: string;
+    };
+    copy: {
+        line: string;
+    };
+    crown: {
+        game: string;
+        line: string;
+    };
+    energy: {
+        game: string;
+        line: string;
+    };
+    gem: {
+        game: string;
+        line: string;
+    };
+    gift: {
+        game: string;
+        line: string;
+    };
+    globe: {
+        line: string;
+    };
+    history: {
+        line: string;
+    };
+    home: {
+        line: string;
+    };
+    hourglass: {
+        game: string;
+        line: string;
+    };
+    laurel: {
+        game: string;
+    };
+    lock: {
+        game: string;
+        line: string;
+    };
+    lucky: {
+        game: string;
+    };
+    mail: {
+        game: string;
+        line: string;
+    };
+    medal: {
+        game: string;
+        line: string;
+    };
+    mission: {
+        game: string;
+    };
+    mobile: {
+        line: string;
+    };
+    portal: {
+        game: string;
+        line: string;
+    };
+    scroll: {
+        game: string;
+        line: string;
+    };
+    settings: {
+        game: string;
+        line: string;
+    };
+    shirt: {
+        line: string;
+    };
+    shop: {
+        game: string;
+        line: string;
+    };
+    smile: {
+        line: string;
+    };
+    timer: {
+        game: string;
+        line: string;
+    };
+    trophy: {
+        game: string;
+        line: string;
+    };
+    undo: {
+        line: string;
+    };
+    redo: {
+        line: string;
+    };
+    vote: {
+        game: string;
+        line: string;
+    };
+};
+
+export declare const CLAY_LAYER_TOKENS: {
+    readonly playfield: "var(--game-ui-z-playfield)";
+    readonly hud: "var(--game-ui-z-hud)";
+    readonly sidebar: "var(--game-ui-z-sidebar)";
+    readonly overlay: "var(--game-ui-z-overlay)";
+    readonly modal: "var(--game-ui-z-modal)";
+    readonly toast: "var(--game-ui-z-toast)";
+};
+
+export declare const CLAY_MOTION_TOKENS: {
+    readonly fast: "var(--game-ui-motion-fast)";
+    readonly base: "var(--game-ui-motion-base)";
+    readonly slow: "var(--game-ui-motion-slow)";
+    readonly easingPop: "var(--game-ui-ease-pop)";
+    readonly easingSoft: "var(--game-ui-ease-soft)";
+    readonly reducedMotion: "var(--game-ui-reduced-motion-policy)";
+};
+
+export declare const CLAY_RADIUS_TOKENS: {
+    readonly bead: "var(--game-ui-radius-bead)";
+    readonly control: "var(--game-ui-radius-control)";
+    readonly card: "var(--game-ui-radius-card)";
+    readonly panel: "var(--game-ui-radius-panel)";
+    readonly modal: "var(--game-ui-radius-modal)";
+};
+
+export declare const CLAY_SEMANTIC_TOKENS: {
+    readonly background: "var(--game-ui-bg)";
+    readonly playfieldScrim: "var(--game-ui-playfield-scrim)";
+    readonly surface: "var(--game-ui-surface)";
+    readonly surfaceRaised: "var(--game-ui-surface-raised)";
+    readonly panel: "var(--game-ui-panel)";
+    readonly panelStrong: "var(--game-ui-panel-strong)";
+    readonly text: "var(--game-ui-text)";
+    readonly textMuted: "var(--game-ui-text-muted)";
+    readonly accent: "var(--game-ui-accent)";
+    readonly accentContrast: "var(--game-ui-accent-contrast)";
+    readonly secondary: "var(--game-ui-secondary)";
+    readonly success: "var(--game-ui-success)";
+    readonly danger: "var(--game-ui-danger)";
+    readonly warning: "var(--game-ui-warning)";
+    readonly focusRing: "var(--game-ui-focus-ring)";
+    readonly borderSubtle: "var(--game-ui-border-subtle)";
+    readonly borderStrong: "var(--game-ui-border-strong)";
+    readonly disabled: "var(--game-ui-disabled)";
+};
+
+export declare const CLAY_SPACE_TOKENS: {
+    readonly px2: "var(--game-ui-space-2)";
+    readonly px4: "var(--game-ui-space-4)";
+    readonly px6: "var(--game-ui-space-6)";
+    readonly px8: "var(--game-ui-space-8)";
+    readonly px10: "var(--game-ui-space-10)";
+    readonly px12: "var(--game-ui-space-12)";
+    readonly px16: "var(--game-ui-space-16)";
+    readonly px20: "var(--game-ui-space-20)";
+    readonly px24: "var(--game-ui-space-24)";
+    readonly px32: "var(--game-ui-space-32)";
+    readonly safeTop: "var(--game-ui-safe-top)";
+    readonly safeRight: "var(--game-ui-safe-right)";
+    readonly safeBottom: "var(--game-ui-safe-bottom)";
+    readonly safeLeft: "var(--game-ui-safe-left)";
+};
+
+export declare const CLAY_TARGET_TOKENS: {
+    readonly touchMinimumPx: 44;
+    readonly touchPrimaryPx: 52;
+    readonly touchIconPx: 48;
+    readonly touchRowPx: 46;
+    readonly adjacentSpacingPx: 8;
+    readonly mobileLandscapeMinHeightPx: 390;
+    readonly desktopProofWidthPx: 1440;
+    readonly desktopProofHeightPx: 900;
+    readonly mobileLandscapeProofWidthPx: 844;
+    readonly mobileLandscapeProofHeightPx: 390;
+};
+
+export declare const CLAY_TYPE_TOKENS: {
+    readonly familyDisplay: "var(--game-ui-font-display)";
+    readonly familyBody: "var(--game-ui-font-body)";
+    readonly xs: "var(--game-ui-font-xs)";
+    readonly sm: "var(--game-ui-font-sm)";
+    readonly md: "var(--game-ui-font-md)";
+    readonly lg: "var(--game-ui-font-lg)";
+    readonly xl: "var(--game-ui-font-xl)";
+    readonly xxl: "var(--game-ui-font-xxl)";
+    readonly lineTight: "var(--game-ui-line-tight)";
+    readonly lineBody: "var(--game-ui-line-body)";
+    readonly weightBody: "var(--game-ui-weight-body)";
+    readonly weightStrong: "var(--game-ui-weight-strong)";
+    readonly weightTitle: "var(--game-ui-weight-title)";
+};
+
+export declare const CLAY_UI_TOKENS: {
+    readonly colors: {
+        readonly ink: "#3b2d23";
+        readonly inkMuted: "#7b6652";
+        readonly parchment: "#fff8ec";
+        readonly parchmentDeep: "#f4e2c6";
+        readonly cream: "#f3e8d8";
+        readonly wood: "#6c4f38";
+        readonly woodDeep: "#3a2518";
+        readonly honey: "#f2b35c";
+        readonly orange: "#e8743b";
+        readonly teal: "#1d9a8b";
+        readonly green: "#4f9d6b";
+        readonly mint: "#7ee0b6";
+        readonly berry: "#9b6dd6";
+        readonly red: "#d85a45";
+        readonly sky: "#5ca6d8";
+        readonly shadow: "rgba(76, 52, 28, 0.24)";
+        readonly glass: "rgba(255, 248, 236, 0.82)";
+        readonly nightGlass: "rgba(31, 24, 18, 0.76)";
+    };
+    readonly semantic: {
+        readonly background: "var(--game-ui-bg)";
+        readonly playfieldScrim: "var(--game-ui-playfield-scrim)";
+        readonly surface: "var(--game-ui-surface)";
+        readonly surfaceRaised: "var(--game-ui-surface-raised)";
+        readonly panel: "var(--game-ui-panel)";
+        readonly panelStrong: "var(--game-ui-panel-strong)";
+        readonly text: "var(--game-ui-text)";
+        readonly textMuted: "var(--game-ui-text-muted)";
+        readonly accent: "var(--game-ui-accent)";
+        readonly accentContrast: "var(--game-ui-accent-contrast)";
+        readonly secondary: "var(--game-ui-secondary)";
+        readonly success: "var(--game-ui-success)";
+        readonly danger: "var(--game-ui-danger)";
+        readonly warning: "var(--game-ui-warning)";
+        readonly focusRing: "var(--game-ui-focus-ring)";
+        readonly borderSubtle: "var(--game-ui-border-subtle)";
+        readonly borderStrong: "var(--game-ui-border-strong)";
+        readonly disabled: "var(--game-ui-disabled)";
+    };
+    readonly typography: {
+        readonly familyDisplay: "var(--game-ui-font-display)";
+        readonly familyBody: "var(--game-ui-font-body)";
+        readonly xs: "var(--game-ui-font-xs)";
+        readonly sm: "var(--game-ui-font-sm)";
+        readonly md: "var(--game-ui-font-md)";
+        readonly lg: "var(--game-ui-font-lg)";
+        readonly xl: "var(--game-ui-font-xl)";
+        readonly xxl: "var(--game-ui-font-xxl)";
+        readonly lineTight: "var(--game-ui-line-tight)";
+        readonly lineBody: "var(--game-ui-line-body)";
+        readonly weightBody: "var(--game-ui-weight-body)";
+        readonly weightStrong: "var(--game-ui-weight-strong)";
+        readonly weightTitle: "var(--game-ui-weight-title)";
+    };
+    readonly spacing: {
+        readonly px2: "var(--game-ui-space-2)";
+        readonly px4: "var(--game-ui-space-4)";
+        readonly px6: "var(--game-ui-space-6)";
+        readonly px8: "var(--game-ui-space-8)";
+        readonly px10: "var(--game-ui-space-10)";
+        readonly px12: "var(--game-ui-space-12)";
+        readonly px16: "var(--game-ui-space-16)";
+        readonly px20: "var(--game-ui-space-20)";
+        readonly px24: "var(--game-ui-space-24)";
+        readonly px32: "var(--game-ui-space-32)";
+        readonly safeTop: "var(--game-ui-safe-top)";
+        readonly safeRight: "var(--game-ui-safe-right)";
+        readonly safeBottom: "var(--game-ui-safe-bottom)";
+        readonly safeLeft: "var(--game-ui-safe-left)";
+    };
+    readonly radius: {
+        readonly bead: "var(--game-ui-radius-bead)";
+        readonly control: "var(--game-ui-radius-control)";
+        readonly card: "var(--game-ui-radius-card)";
+        readonly panel: "var(--game-ui-radius-panel)";
+        readonly modal: "var(--game-ui-radius-modal)";
+    };
+    readonly elevation: {
+        readonly button: "var(--game-ui-shadow-button)";
+        readonly panel: "var(--game-ui-shadow-panel)";
+        readonly modal: "var(--game-ui-shadow-modal)";
+        readonly inset: "var(--game-ui-shadow-inset)";
+        readonly stroke: "var(--game-ui-stroke)";
+    };
+    readonly motion: {
+        readonly fast: "var(--game-ui-motion-fast)";
+        readonly base: "var(--game-ui-motion-base)";
+        readonly slow: "var(--game-ui-motion-slow)";
+        readonly easingPop: "var(--game-ui-ease-pop)";
+        readonly easingSoft: "var(--game-ui-ease-soft)";
+        readonly reducedMotion: "var(--game-ui-reduced-motion-policy)";
+    };
+    readonly layers: {
+        readonly playfield: "var(--game-ui-z-playfield)";
+        readonly hud: "var(--game-ui-z-hud)";
+        readonly sidebar: "var(--game-ui-z-sidebar)";
+        readonly overlay: "var(--game-ui-z-overlay)";
+        readonly modal: "var(--game-ui-z-modal)";
+        readonly toast: "var(--game-ui-z-toast)";
+    };
+    readonly targets: {
+        readonly touchMinimumPx: 44;
+        readonly touchPrimaryPx: 52;
+        readonly touchIconPx: 48;
+        readonly touchRowPx: 46;
+        readonly adjacentSpacingPx: 8;
+        readonly mobileLandscapeMinHeightPx: 390;
+        readonly desktopProofWidthPx: 1440;
+        readonly desktopProofHeightPx: 900;
+        readonly mobileLandscapeProofWidthPx: 844;
+        readonly mobileLandscapeProofHeightPx: 390;
+    };
+    readonly assetSizing: {
+        readonly iconSm: "var(--game-ui-asset-icon-sm)";
+        readonly iconMd: "var(--game-ui-asset-icon-md)";
+        readonly iconLg: "var(--game-ui-asset-icon-lg)";
+        readonly iconXl: "var(--game-ui-asset-icon-xl)";
+        readonly buttonSkinMinWidth: "var(--game-ui-asset-button-min-width)";
+        readonly cardFanWidth: "var(--game-ui-asset-card-fan-width)";
+        readonly stageTileMinHeight: "var(--game-ui-stage-tile-min-height)";
+        readonly terrainSwatchSize: "var(--game-ui-terrain-swatch-size)";
+        readonly terrainToolHitSize: "var(--game-ui-terrain-tool-hit-size)";
+        readonly buildRailCardSize: "var(--game-ui-build-rail-card-size)";
+        readonly brushNumberWidth: "var(--game-ui-brush-number-width)";
+    };
+};
+
+export declare type ClayAssetGroup = keyof typeof CLAY_ASSETS;
+
+export declare type ClayAssetMode = 'inline' | 'source';
+
+export declare type ClayGameSpriteName = keyof typeof CLAY_GAME_SPRITES;
+
+export declare type ClayIconName = keyof typeof CLAY_ICON_VARIANTS;
+
+export declare interface ClayIconResolveOptions {
+    /** Force a specific visual family. Defaults to game-preferred resolution. */
+    style?: ClayIconStyle;
+    /** Force inline SVG placeholder (true) or real PNG path (false). */
+    inline?: boolean;
+}
+
+/**
+ * Clay icons ship in two visual families, and which one you use is a deliberate
+ * design choice:
+ *
+ * - 'game'  — the colorful, sculpted clay objects under `icons/common/*`
+ *             (crown, scroll, trophy, key…). This is the primary, on-brand look
+ *             and the default everywhere. Use it for anything the player sees.
+ * - 'line'  — the flat, white, monochrome glyphs under `icons/function/*`
+ *             (home, compass, chat…). This is the alternate/utility family for
+ *             dense toolbars or places a sculpted object would feel too heavy.
+ *
+ * Not every semantic icon exists in both families: the game family is a curated
+ * set of ~45 sculpted objects, while the line family covers ~230 generic UI
+ * concepts. `getClayIconStyles()` reports which families a given icon has, and
+ * resolution always prefers 'game' so cards get the on-brand look by default.
+ */
+export declare type ClayIconStyle = 'game' | 'line';
+
+export declare type ClayTokenCategory = keyof typeof CLAY_UI_TOKENS;
+
+export declare function FirstSessionHud({ authenticated, batteryCount, className, dailyStreak, iconSlots, labels, onHistory, onSettings, onWardrobe, playerName }: FirstSessionHudProps): ReactNode;
+
+export declare interface FirstSessionHudIconSlots {
+    history?: ReactNode;
+    input?: ReactNode;
+    settings?: ReactNode;
+    wardrobe?: ReactNode;
+    emote?: ReactNode;
+}
+
+export declare interface FirstSessionHudLabels {
+    controls: string;
+    emote: string;
+    goalLabel: string;
+    goalValue: string;
+    /** Streak prefix, e.g. "Daily" → "Daily 3". Defaults to "Daily". */
+    streak?: string;
+    /** Resource meta shown for guests (unauthenticated). Defaults to "guest". */
+    guest?: string;
+    history: string;
+    hud: string;
+    input: string;
+    moveBadge: string;
+    move: string;
+    roomLabel: string;
+    roomValue: string;
+    roleLabel: string;
+    roleValue: string;
+    settings: string;
+    shell: string;
+    timerLabel: string;
+    timerValue: string;
+    tools: string;
+    wardrobe: string;
+}
+
+export declare interface FirstSessionHudProps {
+    authenticated: boolean;
+    batteryCount: number | string;
+    className?: string;
+    dailyStreak: number;
+    iconSlots?: FirstSessionHudIconSlots;
+    labels: FirstSessionHudLabels;
+    onHistory: () => void;
+    onSettings: () => void;
+    onWardrobe: () => void;
+    playerName: string;
+}
+
+export declare function FirstSessionOnboarding({ labels, onDismiss, open }: FirstSessionOnboardingProps): ReactNode;
+
+export declare interface FirstSessionOnboardingLabels {
+    badge: string;
+    body: string;
+    skip: string;
+    start: string;
+    steps: readonly FirstSessionOnboardingStep[];
+    title: string;
+}
+
+export declare interface FirstSessionOnboardingProps {
+    labels: FirstSessionOnboardingLabels;
+    onDismiss: () => void;
+    open: boolean;
+}
+
+export declare interface FirstSessionOnboardingStep {
+    body: string;
+    title: string;
+}
+
+export declare const GAME_UI_PREVIEW_MESSAGES: readonly GameUiHistoryEntry[];
+
+export declare const GAME_UI_TARGETS: {
+    readonly touchMinimumPx: 44;
+    readonly touchPrimaryPx: 52;
+    readonly touchIconPx: 48;
+    readonly touchRowPx: 46;
+    readonly adjacentSpacingPx: 8;
+    readonly mobileLandscapeMinHeightPx: 390;
+    readonly desktopProofWidthPx: 1440;
+    readonly desktopProofHeightPx: 900;
+    readonly mobileLandscapeProofWidthPx: 844;
+    readonly mobileLandscapeProofHeightPx: 390;
+};
+
+export declare const GAME_UI_TOKENS: {
+    readonly iconSm: "var(--game-ui-asset-icon-sm)";
+    readonly iconMd: "var(--game-ui-asset-icon-md)";
+    readonly iconLg: "var(--game-ui-asset-icon-lg)";
+    readonly iconXl: "var(--game-ui-asset-icon-xl)";
+    readonly buttonSkinMinWidth: "var(--game-ui-asset-button-min-width)";
+    readonly cardFanWidth: "var(--game-ui-asset-card-fan-width)";
+    readonly stageTileMinHeight: "var(--game-ui-stage-tile-min-height)";
+    readonly terrainSwatchSize: "var(--game-ui-terrain-swatch-size)";
+    readonly terrainToolHitSize: "var(--game-ui-terrain-tool-hit-size)";
+    readonly buildRailCardSize: "var(--game-ui-build-rail-card-size)";
+    readonly brushNumberWidth: "var(--game-ui-brush-number-width)";
+    readonly playfield: "var(--game-ui-z-playfield)";
+    readonly hud: "var(--game-ui-z-hud)";
+    readonly sidebar: "var(--game-ui-z-sidebar)";
+    readonly overlay: "var(--game-ui-z-overlay)";
+    readonly modal: "var(--game-ui-z-modal)";
+    readonly toast: "var(--game-ui-z-toast)";
+    readonly fast: "var(--game-ui-motion-fast)";
+    readonly base: "var(--game-ui-motion-base)";
+    readonly slow: "var(--game-ui-motion-slow)";
+    readonly easingPop: "var(--game-ui-ease-pop)";
+    readonly easingSoft: "var(--game-ui-ease-soft)";
+    readonly reducedMotion: "var(--game-ui-reduced-motion-policy)";
+    readonly button: "var(--game-ui-shadow-button)";
+    readonly panel: "var(--game-ui-shadow-panel)";
+    readonly inset: "var(--game-ui-shadow-inset)";
+    readonly stroke: "var(--game-ui-stroke)";
+    readonly bead: "var(--game-ui-radius-bead)";
+    readonly control: "var(--game-ui-radius-control)";
+    readonly card: "var(--game-ui-radius-card)";
+    readonly px2: "var(--game-ui-space-2)";
+    readonly px4: "var(--game-ui-space-4)";
+    readonly px6: "var(--game-ui-space-6)";
+    readonly px8: "var(--game-ui-space-8)";
+    readonly px10: "var(--game-ui-space-10)";
+    readonly px12: "var(--game-ui-space-12)";
+    readonly px16: "var(--game-ui-space-16)";
+    readonly px20: "var(--game-ui-space-20)";
+    readonly px24: "var(--game-ui-space-24)";
+    readonly px32: "var(--game-ui-space-32)";
+    readonly safeTop: "var(--game-ui-safe-top)";
+    readonly safeRight: "var(--game-ui-safe-right)";
+    readonly safeBottom: "var(--game-ui-safe-bottom)";
+    readonly safeLeft: "var(--game-ui-safe-left)";
+    readonly familyDisplay: "var(--game-ui-font-display)";
+    readonly familyBody: "var(--game-ui-font-body)";
+    readonly xs: "var(--game-ui-font-xs)";
+    readonly sm: "var(--game-ui-font-sm)";
+    readonly md: "var(--game-ui-font-md)";
+    readonly lg: "var(--game-ui-font-lg)";
+    readonly xl: "var(--game-ui-font-xl)";
+    readonly xxl: "var(--game-ui-font-xxl)";
+    readonly lineTight: "var(--game-ui-line-tight)";
+    readonly lineBody: "var(--game-ui-line-body)";
+    readonly weightBody: "var(--game-ui-weight-body)";
+    readonly weightStrong: "var(--game-ui-weight-strong)";
+    readonly weightTitle: "var(--game-ui-weight-title)";
+    readonly background: "var(--game-ui-bg)";
+    readonly playfieldScrim: "var(--game-ui-playfield-scrim)";
+    readonly surface: "var(--game-ui-surface)";
+    readonly surfaceRaised: "var(--game-ui-surface-raised)";
+    readonly panelStrong: "var(--game-ui-panel-strong)";
+    readonly text: "var(--game-ui-text)";
+    readonly textMuted: "var(--game-ui-text-muted)";
+    readonly accent: "var(--game-ui-accent)";
+    readonly accentContrast: "var(--game-ui-accent-contrast)";
+    readonly secondary: "var(--game-ui-secondary)";
+    readonly success: "var(--game-ui-success)";
+    readonly danger: "var(--game-ui-danger)";
+    readonly warning: "var(--game-ui-warning)";
+    readonly focusRing: "var(--game-ui-focus-ring)";
+    readonly borderSubtle: "var(--game-ui-border-subtle)";
+    readonly borderStrong: "var(--game-ui-border-strong)";
+    readonly disabled: "var(--game-ui-disabled)";
+};
+
+export declare function GameActionGrid({ actions, className, density, iconLabelMode, label, style }: GameActionGridProps): ReactNode;
+
+export declare interface GameActionGridProps {
+    actions: readonly GameUiAction[];
+    className?: string;
+    density?: GameSurfaceDensity;
+    iconLabelMode?: GameActionIconLabelMode;
+    label: string;
+    style?: GameActionStyle;
+}
+
+export declare type GameActionIconLabelMode = 'hidden' | 'caption';
+
+export declare type GameActionStyle = 'button' | 'icon';
+
+export declare interface GameAssetBadge {
+    label: string;
+    tone?: GameBadgeTone;
+}
+
+export declare function GameAssetCard({ assetId, badges, cardLayout, className, description, disabled, facts, icon, onClick, onSelect, selected, source, sourceLabel, status, statusLabel, thumbnailAlt, thumbnailSrc, title, type, ...props }: GameAssetCardProps): ReactNode;
+
+export declare type GameAssetCardLayout = 'auto' | 'list' | 'rail';
+
+export declare interface GameAssetCardProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'children' | 'onSelect'> {
+    assetId: string;
+    badges?: readonly GameAssetBadge[];
+    cardLayout?: Exclude<GameAssetCardLayout, 'auto'>;
+    description?: string;
+    facts?: readonly GameAssetFact[];
+    icon?: ClayIconName;
+    onSelect?: (assetId: string) => void;
+    selected?: boolean;
+    source: GameAssetSource;
+    sourceLabel?: string;
+    status?: GameAssetStatus;
+    statusLabel?: string;
+    thumbnailAlt?: string;
+    thumbnailSrc?: string;
+    title: string;
+}
+
+export declare interface GameAssetFact {
+    id: string;
+    label: string;
+    value: string;
+}
+
+export declare interface GameAssetGroup {
+    assets: readonly Omit<GameAssetCardProps, 'onSelect' | 'selected'>[];
+    id: string;
+    label: string;
+    source?: GameAssetSource;
+}
+
+export declare function GameAssetIcon({ className, icon, label, size, style, useSourceAsset }: GameAssetIconProps): ReactNode;
+
+export declare interface GameAssetIconProps {
+    className?: string;
+    icon: ClayIconName;
+    label?: string;
+    size?: 'sm' | 'md' | 'lg' | 'xl';
+    /**
+     * Visual family. 'game' (default) is the colorful sculpted clay object;
+     * 'line' is the flat white glyph alternate. Falls back automatically when an
+     * icon only ships one family.
+     */
+    style?: ClayIconStyle;
+    useSourceAsset?: boolean;
+}
+
+export declare function GameAssetLibrary({ cardLayout, className, density, emptyAction, emptyDescription, emptyTitle, groups, label, onSelectAsset, selectedAssetId, subtitle, title, }: GameAssetLibraryProps): ReactNode;
+
+export declare interface GameAssetLibraryProps {
+    cardLayout?: GameAssetCardLayout;
+    className?: string;
+    density?: GameSurfaceDensity;
+    emptyAction?: ReactNode;
+    emptyDescription?: string;
+    emptyTitle?: string;
+    groups: readonly GameAssetGroup[];
+    label: string;
+    onSelectAsset?: (assetId: string) => void;
+    selectedAssetId?: string;
+    subtitle?: string;
+    title: string;
+}
+
+export declare type GameAssetSource = 'starter' | 'generated' | 'imported';
+
+export declare type GameAssetStatus = 'ready' | 'generating' | 'missing' | 'placed' | 'selected' | 'error';
+
+export declare function GameAvatar({ className, name, size, src, status }: GameAvatarProps): ReactNode;
+
+export declare interface GameAvatarProps {
+    /** Display name — used as image alt text and for the initials fallback. */
+    name: string;
+    /** Optional image URL; when missing, initials are shown instead. */
+    src?: string;
+    size?: 'sm' | 'md' | 'lg' | 'xl';
+    /** Presence dot; 'none' hides it. */
+    status?: 'none' | 'online' | 'busy' | 'away';
+    className?: string;
+}
+
+export declare function GameBadge({ children, className, tone }: GameBadgeProps): ReactNode;
+
+export declare interface GameBadgeProps {
+    children: ReactNode;
+    className?: string;
+    tone?: GameBadgeTone;
+}
+
+export declare type GameBadgeTone = 'neutral' | 'success' | 'warning' | 'danger' | 'ai';
+
+export declare function GameBeforeAfterToggle({ activeView, after, before, className, label, onViewChange, variant, 'data-testid': testId, }: GameBeforeAfterToggleProps): ReactNode;
+
+export declare interface GameBeforeAfterToggleProps {
+    activeView: GameBeforeAfterView;
+    after: GameConstructionPreviewPane;
+    before: GameConstructionPreviewPane;
+    className?: string | undefined;
+    label: string;
+    onViewChange?: ((view: GameBeforeAfterView) => void) | undefined;
+    variant?: GameConstructionVariant | undefined;
+    'data-testid'?: string | undefined;
+}
+
+export declare type GameBeforeAfterView = 'before' | 'after';
+
+export declare interface GameBrushControlLabels {
+    radius?: string;
+    strength?: string;
+    radiusHint?: string;
+    strengthHint?: string;
+}
+
+export declare function GameBrushControls({ className, labels, onRadiusChange, onStrengthChange, state, variant, 'data-testid': testId, }: GameBrushControlsProps): ReactNode;
+
+export declare interface GameBrushControlsProps {
+    className?: string;
+    labels?: GameBrushControlLabels;
+    onRadiusChange?: ((radius: number) => void) | undefined;
+    onStrengthChange?: ((strength: number) => void) | undefined;
+    state: GameBrushControlState;
+    variant?: GameTerrainBuildVariant;
+    'data-testid'?: string | undefined;
+}
+
+export declare interface GameBrushControlState {
+    disabled?: boolean;
+    maxRadius?: number;
+    maxStrength?: number;
+    minRadius?: number;
+    minStrength?: number;
+    radius: number;
+    radiusStep?: number;
+    strength: number;
+    strengthStep?: number;
+}
+
+export declare interface GameBuildCategory {
+    compactLabel?: string;
+    disabled?: boolean;
+    icon?: ClayIconName;
+    id: GameBuildCategoryId;
+    items: readonly GameBuildItem[];
+    label: string;
+    meta?: string;
+}
+
+export declare type GameBuildCategoryId = 'foundation' | 'wall' | 'opening' | 'roof' | 'prop' | 'house' | string;
+
+export declare interface GameBuildItem {
+    badges?: readonly {
+        label: string;
+        tone?: GameBadgeTone;
+    }[];
+    compactLabel?: string;
+    description?: string;
+    disabled?: boolean;
+    icon?: ClayIconName;
+    id: string;
+    label: string;
+    meta?: string;
+    previewAlt?: string;
+    previewSrc?: string;
+    status?: GameBuildItemStatus;
+}
+
+export declare type GameBuildItemStatus = 'ready' | 'selected' | 'locked' | 'missing' | 'progress' | 'error';
+
+export declare function GameBuildLibrary({ activeCategoryId, categories, className, density, emptyDescription, emptyTitle, label, onCategoryChange, onSelectItem, selectedItemId, title, variant, 'data-testid': testId, }: GameBuildLibraryProps): ReactNode;
+
+export declare interface GameBuildLibraryProps {
+    activeCategoryId?: string | undefined;
+    categories: readonly GameBuildCategory[];
+    className?: string;
+    density?: GameSurfaceDensity;
+    emptyDescription?: string;
+    emptyTitle?: string;
+    label: string;
+    onCategoryChange?: ((categoryId: string) => void) | undefined;
+    onSelectItem?: ((itemId: string, categoryId: string) => void) | undefined;
+    selectedItemId?: string | undefined;
+    title: string;
+    variant?: GameTerrainBuildVariant;
+    'data-testid'?: string | undefined;
+}
+
+export declare function GameButton({ children, className, onClick, sound, static: isStatic, type, variant, ...props }: GameButtonProps): ReactNode;
+
+export declare interface GameButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+    children: ReactNode;
+    sound?: GameInteractionSoundOptions | false;
+    /** Disable the scale-on-press feedback where the motion would distract. */
+    static?: boolean;
+    variant?: GameButtonVariant;
+}
+
+export declare type GameButtonVariant = 'primary' | 'secondary' | 'ghost' | 'danger' | 'success';
+
+export declare function GameCardFan({ cards, className, label }: GameCardFanProps): ReactNode;
+
+export declare interface GameCardFanCard {
+    id: string;
+    icon?: ClayIconName;
+    kicker: string;
+    title: string;
+}
+
+export declare interface GameCardFanProps {
+    cards: readonly GameCardFanCard[];
+    className?: string;
+    label: string;
+}
+
+export declare function GameCheckbox({ className, label, ...props }: GameCheckboxProps): ReactNode;
+
+export declare interface GameCheckboxProps extends Pick<InputHTMLAttributes<HTMLInputElement>, 'checked' | 'defaultChecked' | 'disabled' | 'name' | 'onChange' | 'required' | 'value'> {
+    label: string;
+    className?: string;
+}
+
+export declare function GameCollapsiblePanel({ actions, children, className, defaultOpen, labels, onOpenChange, open, title, tone, ...props }: GameCollapsiblePanelProps): ReactNode;
+
+export declare interface GameCollapsiblePanelLabels {
+    collapse: string;
+    expand: string;
+}
+
+export declare interface GameCollapsiblePanelProps extends Omit<HTMLAttributes<HTMLElement>, 'title'> {
+    children: ReactNode;
+    className?: string;
+    /** Controlled open state. Leave undefined for uncontrolled usage. */
+    open?: boolean;
+    /** Uncontrolled initial state. Defaults to true (expanded). */
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    /** Extra header actions rendered next to the toggle (e.g. icon buttons). */
+    actions?: ReactNode;
+    labels?: Partial<GameCollapsiblePanelLabels>;
+    title: string;
+    tone?: 'default' | 'strong';
+}
+
+export declare function GameCompactGameDrawer({ children, className, closeIcon, closeLabel, disabled, label, onOpenChange, open, panelId: providedPanelId, title, triggerIcon, triggerLabel, variant, 'data-testid': testId, }: GameCompactGameDrawerProps): ReactNode;
+
+export declare interface GameCompactGameDrawerProps {
+    children: ReactNode;
+    className?: string;
+    closeIcon?: ClayIconName;
+    closeLabel?: string;
+    disabled?: boolean;
+    label: string;
+    onOpenChange?: ((open: boolean) => void) | undefined;
+    open: boolean;
+    panelId?: string;
+    title: string;
+    triggerIcon?: ClayIconName;
+    triggerLabel?: string;
+    variant?: GameTerrainBuildVariant;
+    'data-testid'?: string | undefined;
+}
+
+export declare function GameCompactJobDrawer({ children, className, closeLabel, disabled, jobs, label, onAction, onOpenChange, onSelectJob, open, panelId, selectedJobId, title, triggerLabel, variant, 'data-testid': testId, }: GameCompactJobDrawerProps): ReactNode;
+
+export declare interface GameCompactJobDrawerProps {
+    children?: ReactNode | undefined;
+    className?: string | undefined;
+    closeLabel?: string | undefined;
+    disabled?: boolean | undefined;
+    jobs?: readonly GameConstructionJob[] | undefined;
+    label: string;
+    onAction?: ((actionId: string, jobId: string) => void) | undefined;
+    onOpenChange?: ((open: boolean) => void) | undefined;
+    onSelectJob?: ((jobId: string) => void) | undefined;
+    open: boolean;
+    panelId?: string | undefined;
+    selectedJobId?: string | undefined;
+    title: string;
+    triggerLabel?: string | undefined;
+    variant?: Extract<GameConstructionVariant, 'mobile' | 'small-mobile'> | undefined;
+    'data-testid'?: string | undefined;
+}
+
+export declare interface GameConstructionAction {
+    ariaLabel?: string | undefined;
+    disabled?: boolean | undefined;
+    icon?: ClayIconName | undefined;
+    id: GameConstructionActionId;
+    label: string;
+    meta?: string | undefined;
+    tone?: GameButtonVariant | undefined;
+}
+
+export declare type GameConstructionActionId = 'approve' | 'cancel' | 'preview' | 'revise' | 'revert' | string;
+
+export declare function GameConstructionApprovalBar({ actions, className, disabled, label, localOnlyLabel, onAction, providerMode, status, validationWarnings, variant, 'data-testid': testId, }: GameConstructionApprovalBarProps): ReactNode;
+
+export declare interface GameConstructionApprovalBarProps {
+    actions?: readonly GameConstructionAction[] | undefined;
+    className?: string | undefined;
+    disabled?: boolean | undefined;
+    label: string;
+    localOnlyLabel?: string | undefined;
+    onAction?: ((actionId: string) => void) | undefined;
+    providerMode?: GameConstructionProviderMode | undefined;
+    status: GameConstructionJobStatus;
+    validationWarnings?: readonly GameConstructionValidationWarning[] | undefined;
+    variant?: GameConstructionVariant | undefined;
+    'data-testid'?: string | undefined;
+}
+
+export declare interface GameConstructionBadge {
+    label: string;
+    tone?: GameBadgeTone | undefined;
+}
+
+export declare interface GameConstructionFact {
+    id: string;
+    label: string;
+    value: ReactNode;
+}
+
+export declare interface GameConstructionJob {
+    actions?: readonly GameConstructionAction[] | undefined;
+    after?: GameConstructionPreviewPane | undefined;
+    badges?: readonly GameConstructionBadge[] | undefined;
+    before?: GameConstructionPreviewPane | undefined;
+    crew?: readonly GameRobotCrewMember[] | undefined;
+    description?: string | undefined;
+    estimate?: string | undefined;
+    facts?: readonly GameConstructionFact[] | undefined;
+    id: string;
+    location?: string | undefined;
+    progressLabel?: string | undefined;
+    progressMax?: number | undefined;
+    progressValue?: number | undefined;
+    providerMode?: GameConstructionProviderMode | undefined;
+    status: GameConstructionJobStatus;
+    statusLabel?: string | undefined;
+    steps?: readonly GameConstructionProgressStep[] | undefined;
+    title: string;
+    validationWarnings?: readonly GameConstructionValidationWarning[] | undefined;
+}
+
+export declare function GameConstructionJobCard({ className, density, job, onAction, onSelect, selected, showApprovalBar, showBeforeAfter, variant, 'data-testid': testId, }: GameConstructionJobCardProps): ReactNode;
+
+export declare interface GameConstructionJobCardProps {
+    className?: string | undefined;
+    density?: GameSurfaceDensity | undefined;
+    job: GameConstructionJob;
+    onAction?: ((actionId: string, jobId: string) => void) | undefined;
+    onSelect?: ((jobId: string) => void) | undefined;
+    selected?: boolean | undefined;
+    showApprovalBar?: boolean | undefined;
+    showBeforeAfter?: boolean | undefined;
+    variant?: GameConstructionVariant | undefined;
+    'data-testid'?: string | undefined;
+}
+
+export declare type GameConstructionJobStatus = 'draft' | 'preview' | 'queued' | 'working' | 'blocked' | 'readyForReview' | 'accepted' | 'cancelled';
+
+export declare interface GameConstructionPreviewPane {
+    caption?: string | undefined;
+    content?: ReactNode | undefined;
+    label: string;
+}
+
+export declare function GameConstructionProgress({ className, label, max, progressLabel, showStatusBadge, status, statusLabel: explicitStatusLabel, steps, validationWarnings, value, variant, 'data-testid': testId, }: GameConstructionProgressProps): ReactNode;
+
+export declare interface GameConstructionProgressProps {
+    className?: string | undefined;
+    label: string;
+    max?: number | undefined;
+    progressLabel?: string | undefined;
+    showStatusBadge?: boolean | undefined;
+    status: GameConstructionJobStatus;
+    statusLabel?: string | undefined;
+    steps?: readonly GameConstructionProgressStep[] | undefined;
+    validationWarnings?: readonly GameConstructionValidationWarning[] | undefined;
+    value?: number | undefined;
+    variant?: GameConstructionVariant | undefined;
+    'data-testid'?: string | undefined;
+}
+
+export declare interface GameConstructionProgressStep {
+    caption?: string | undefined;
+    id: string;
+    label: string;
+    status: GameConstructionProgressStepStatus;
+}
+
+export declare type GameConstructionProgressStepStatus = 'pending' | 'active' | 'complete' | 'blocked';
+
+export declare type GameConstructionProviderMode = 'local-only' | 'mock' | 'paid-disabled';
+
+export declare type GameConstructionValidationTone = Extract<GameBadgeTone, 'neutral' | 'success' | 'warning' | 'danger' | 'ai'>;
+
+export declare interface GameConstructionValidationWarning {
+    description?: string | undefined;
+    id: string;
+    label: string;
+    tone?: GameConstructionValidationTone | undefined;
+}
+
+export declare type GameConstructionVariant = 'desktop' | 'tablet' | 'mobile' | 'small-mobile';
+
+export declare function GameContractorPanel({ activePreviewView, className, density, drawerOpen, emptyDescription, emptyTitle, jobs, label, onAction, onDrawerOpenChange, onPreviewViewChange, onSelectJob, selectedJobId, subtitle, title, variant, 'data-testid': testId, }: GameContractorPanelProps): ReactNode;
+
+export declare interface GameContractorPanelProps {
+    activePreviewView?: GameBeforeAfterView | undefined;
+    className?: string | undefined;
+    density?: GameSurfaceDensity | undefined;
+    drawerOpen?: boolean | undefined;
+    emptyDescription?: string | undefined;
+    emptyTitle?: string | undefined;
+    jobs: readonly GameConstructionJob[];
+    label: string;
+    onAction?: ((actionId: string, jobId: string) => void) | undefined;
+    onDrawerOpenChange?: ((open: boolean) => void) | undefined;
+    onPreviewViewChange?: ((view: GameBeforeAfterView) => void) | undefined;
+    onSelectJob?: ((jobId: string) => void) | undefined;
+    selectedJobId?: string | undefined;
+    subtitle?: string | undefined;
+    title: string;
+    variant?: GameConstructionVariant | undefined;
+    'data-testid'?: string | undefined;
+}
+
+export declare function GameDialog({ children, className, title }: GameDialogProps): ReactNode;
+
+export declare interface GameDialogProps {
+    children: ReactNode;
+    className?: string;
+    title: string;
+}
+
+export declare function GameEmptyState({ action, className, description, icon, title }: GameEmptyStateProps): ReactNode;
+
+export declare interface GameEmptyStateProps {
+    /** Optional clay icon shown above the title. */
+    icon?: ClayIconName;
+    title: string;
+    description?: string;
+    /** Optional call-to-action node (e.g. a GameButton). */
+    action?: ReactNode;
+    className?: string;
+}
+
+export declare interface GameFactItem {
+    icon?: ClayIconName;
+    id: string;
+    label: string;
+    meta?: string;
+    tone?: GameBadgeTone;
+    value: ReactNode;
+}
+
+export declare function GameFactList({ className, density, facts, label, variant }: GameFactListProps): ReactNode;
+
+export declare interface GameFactListProps {
+    className?: string;
+    density?: GameSurfaceDensity;
+    facts: readonly GameFactItem[];
+    label: string;
+    variant?: 'facts' | 'stats';
+}
+
+export declare function GameField({ children, className, error, hint, label, required }: GameFieldProps): ReactNode;
+
+export declare interface GameFieldProps {
+    /** The input/textarea this field labels. Rendered inside the <label>. */
+    children: ReactNode;
+    label: string;
+    /** Helper text shown under the field when there is no error. */
+    hint?: string;
+    /** Error text; when set, the field switches to the danger tone and announces. */
+    error?: string;
+    required?: boolean;
+    className?: string;
+}
+
+export declare function GameHistoryPanel({ entries, label }: GameHistoryPanelProps): ReactNode;
+
+export declare interface GameHistoryPanelProps {
+    entries: readonly GameUiHistoryEntry[];
+    label: string;
+}
+
+export declare function GameHud({ actions, className, items, label }: GameHudProps): ReactNode;
+
+export declare function GameHudActions({ children, className, label, ...props }: GameHudActionsProps): ReactNode;
+
+export declare interface GameHudActionsProps extends Omit<HTMLAttributes<HTMLElement>, 'children'> {
+    children: ReactNode;
+    className?: string;
+    label: string;
+}
+
+export declare interface GameHudItem {
+    icon?: ClayIconName;
+    id: string;
+    label: string;
+    meta?: string;
+    value: string;
+}
+
+export declare interface GameHudProps {
+    actions?: ReactNode;
+    className?: string;
+    items: readonly GameHudItem[];
+    label: string;
+}
+
+export declare function GameIconButton({ children, className, label, type, ...props }: GameIconButtonProps): ReactNode;
+
+export declare interface GameIconButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+    children: ReactNode;
+    label: string;
+}
+
+export declare const GameInput: ForwardRefExoticComponent<GameInputProps & RefAttributes<HTMLInputElement>>;
+
+/**
+ * Clay form primitives. These are intentionally thin wrappers over the native
+ * <input>/<textarea>/checkbox so they stay fully accessible and uncontrolled-
+ * or controlled-friendly; the clay look lives entirely in CSS. Text fields use
+ * forwardRef so hosts can focus them (e.g. refocus a chat composer after send).
+ */
+export declare interface GameInputProps extends InputHTMLAttributes<HTMLInputElement> {
+    /** Paints the field in the danger tone for invalid values. */
+    invalid?: boolean;
+}
+
+export declare interface GameInteractionAudioContext {
+    createGain(): GameInteractionGainNode;
+    createOscillator(): GameInteractionOscillatorNode;
+    currentTime: number;
+    destination: unknown;
+    resume(): Promise<void>;
+    state: AudioContextState;
+    suspend?: () => Promise<void>;
+}
+
+export declare interface GameInteractionAudioParam {
+    exponentialRampToValueAtTime(value: number, endTime: number): void;
+    setValueAtTime(value: number, startTime: number): void;
+}
+
+export declare interface GameInteractionGainNode {
+    connect(destination: unknown): void;
+    gain: GameInteractionAudioParam;
+}
+
+export declare interface GameInteractionOscillatorNode {
+    connect(destination: GameInteractionGainNode): void;
+    frequency: GameInteractionAudioParam;
+    start(when?: number): void;
+    stop(when?: number): void;
+    type: OscillatorType;
+}
+
+export declare interface GameInteractionSoundOptions {
+    enabled?: boolean;
+    masterVolume?: number;
+    sfxVolume?: number;
+}
+
+export declare function GameLanguageMenu({ className, currentLabel, label, options, value, defaultValue, onSelect }: GameLanguageMenuProps): ReactNode;
+
+export declare interface GameLanguageMenuProps {
+    className?: string;
+    /** Optional override for the trigger label. Defaults to the selected option's label. */
+    currentLabel?: string;
+    label: string;
+    options: readonly {
+        id: string;
+        label: string;
+        meta: string;
+    }[];
+    /** Controlled selected option id. Omit to let the component own selection. */
+    value?: string;
+    /** Initial selection when uncontrolled. Defaults to the first option. */
+    defaultValue?: string;
+    /** Fires with the chosen option id whenever the user picks a language. */
+    onSelect?: (id: string) => void;
+}
+
+export declare function GameLoadingState({ label, tone }: GameLoadingStateProps): ReactNode;
+
+export declare interface GameLoadingStateProps {
+    label: string;
+    tone?: 'loading' | 'error';
+}
+
+export declare function GameMaterialSwatches({ activeMaterialId, className, disabled, label, materials, onMaterialChange, variant, 'data-testid': testId, }: GameMaterialSwatchesProps): ReactNode;
+
+export declare interface GameMaterialSwatchesProps {
+    activeMaterialId?: string | undefined;
+    className?: string;
+    disabled?: boolean;
+    label: string;
+    materials: readonly GameTerrainMaterialSwatch[];
+    onMaterialChange?: ((materialId: string) => void) | undefined;
+    variant?: GameTerrainBuildVariant;
+    'data-testid'?: string | undefined;
+}
+
+export declare function GameModal({ children, className, closeLabel, closeOnBackdrop, footer, onClose, open, size, title, }: GameModalProps): ReactNode;
+
+export declare interface GameModalProps {
+    children: ReactNode;
+    className?: string;
+    /** Close when the backdrop is clicked. Defaults to true. */
+    closeOnBackdrop?: boolean;
+    closeLabel?: string;
+    footer?: ReactNode;
+    /** Called for every close intent: Esc, backdrop click, and close button. */
+    onClose: () => void;
+    open: boolean;
+    size?: 'sm' | 'md' | 'lg';
+    title: string;
+}
+
+export declare interface GameMovementAction {
+    direction: GameMovementDirection;
+    disabled?: boolean;
+    icon?: ClayIconName;
+    label: string;
+    shortcut?: string;
+    symbol?: string;
+}
+
+export declare type GameMovementDirection = 'forward' | 'backward' | 'left' | 'right' | 'up' | 'down' | 'reset';
+
+export declare function GameMovementPad({ actions, className, density, disabled, helpText, label, layout, onMove, }: GameMovementPadProps): ReactNode;
+
+export declare interface GameMovementPadProps {
+    actions?: readonly GameMovementAction[];
+    className?: string;
+    density?: GameSurfaceDensity;
+    disabled?: boolean;
+    helpText?: string;
+    label: string;
+    layout?: 'dpad' | 'row';
+    onMove?: (direction: GameMovementDirection) => void;
+}
+
+export declare const GameObjectToolbar: typeof GamePlacementToolbar;
+
+export declare type GameObjectToolbarProps = GamePlacementToolbarProps;
+
+export declare function GameOrientationGate({ body, cta, badgeLabel, manualHint, preview, title }: GameOrientationGateProps): ReactNode;
+
+export declare interface GameOrientationGateProps {
+    body: string;
+    cta: string;
+    /** Warning badge text. Defaults to "Landscape only". */
+    badgeLabel?: string;
+    /** Hint shown when the browser blocks the automatic landscape lock. */
+    manualHint?: string;
+    preview?: boolean;
+    title: string;
+}
+
+export declare function GamePanel({ children, className, title, tone, ...props }: GamePanelProps): ReactNode;
+
+export declare interface GamePanelProps extends HTMLAttributes<HTMLElement> {
+    children: ReactNode;
+    className?: string;
+    title?: string;
+    tone?: 'default' | 'strong';
+}
+
+export declare function GamePlacementToolbar({ actions, capacityLabel, className, density, maxObjects, objectActions, placedObjects, selectedLabel, selectedTitle, statusLabel, statusTone, statusValue, title, }: GamePlacementToolbarProps): ReactNode;
+
+export declare interface GamePlacementToolbarProps {
+    actions?: readonly GameUiAction[];
+    capacityLabel?: string;
+    className?: string;
+    density?: GameSurfaceDensity;
+    maxObjects?: number;
+    objectActions?: readonly GameUiAction[];
+    placedObjects?: number;
+    selectedLabel?: string;
+    selectedTitle?: string;
+    statusLabel?: string;
+    statusTone?: GameBadgeTone;
+    statusValue?: string;
+    title: string;
+}
+
+export declare function GameProgress({ className, label, max, showValue, tone, value }: GameProgressProps): ReactNode;
+
+export declare interface GameProgressProps {
+    /** Current value, between 0 and `max`. */
+    value: number;
+    max?: number;
+    /** Accessible label for the progress bar. */
+    label: string;
+    tone?: 'accent' | 'success' | 'danger' | 'warning';
+    /** Show the rounded percentage next to the bar. */
+    showValue?: boolean;
+    className?: string;
+}
+
+export declare function GamePrompt({ actionLabel, children, title }: GamePromptProps): ReactNode;
+
+export declare interface GamePromptProps {
+    actionLabel?: string;
+    children: ReactNode;
+    title: string;
+}
+
+export declare function GameRadialMenu({ items, label }: GameRadialMenuProps): ReactNode;
+
+declare interface GameRadialMenuItem {
+    id: string;
+    label: string;
+}
+
+export declare interface GameRadialMenuProps {
+    items: readonly GameRadialMenuItem[];
+    label: string;
+}
+
+export declare interface GameRobotCrewMember {
+    icon?: ClayIconName | undefined;
+    id: string;
+    name: string;
+    role: string;
+    status: GameRobotCrewMemberStatus;
+    task?: string | undefined;
+}
+
+export declare type GameRobotCrewMemberStatus = 'idle' | 'queued' | 'working' | 'blocked' | 'done';
+
+export declare function GameRobotCrewStatus({ className, crew, emptyDescription, emptyTitle, label, title, variant, 'data-testid': testId, }: GameRobotCrewStatusProps): ReactNode;
+
+export declare interface GameRobotCrewStatusProps {
+    className?: string | undefined;
+    crew: readonly GameRobotCrewMember[];
+    emptyDescription?: string | undefined;
+    emptyTitle?: string | undefined;
+    label: string;
+    title?: string | undefined;
+    variant?: GameConstructionVariant | undefined;
+    'data-testid'?: string | undefined;
+}
+
+export declare const GameSceneHudLayout: typeof GameShell;
+
+export declare type GameSceneHudLayoutProps = GameShellProps;
+
+export declare function GameSegmentedControl({ activeId, label, onSelect, options }: GameSegmentedControlProps): ReactNode;
+
+export declare interface GameSegmentedControlProps {
+    activeId: string;
+    label: string;
+    onSelect?: (id: string) => void;
+    options: readonly GameSegmentedOption[];
+}
+
+declare interface GameSegmentedOption {
+    id: string;
+    label: string;
+}
+
+export declare function GameShell({ assetLibrary, bottomBar, children, className, density, hud, layout, movementPad, overlay, sidePanel, title, }: GameShellProps): ReactNode;
+
+export declare interface GameShellProps {
+    /** Main game runtime surface, usually the host app canvas or 3D scene. */
+    children: ReactNode;
+    /** Asset/library rail. Kept slot-based so the kit never imports app runtime state. */
+    assetLibrary?: ReactNode;
+    /** Bottom or floating object/placement controls. */
+    bottomBar?: ReactNode;
+    className?: string;
+    density?: GameSurfaceDensity;
+    /** Persistent HUD, facts, chips, or app navigation. */
+    hud?: ReactNode;
+    layout?: GameSurfaceLayout;
+    /** Optional movement affordance, usually `GameMovementPad`. */
+    movementPad?: ReactNode;
+    /** Modal, toast, onboarding, or non-blocking overlays. */
+    overlay?: ReactNode;
+    /** Secondary panel slot for inspector/debug/user-owned sidebars. */
+    sidePanel?: ReactNode;
+    /** Accessible label for the whole game surface. */
+    title: string;
+}
+
+export declare function GameSlider({ label, max, min, onChange, value }: GameSliderProps): ReactNode;
+
+export declare interface GameSliderProps extends Pick<InputHTMLAttributes<HTMLInputElement>, 'max' | 'min' | 'value'> {
+    label: string;
+    onChange?: (value: number) => void;
+}
+
+export declare function GameStageTile({ badge, className, icon, kicker, selected, summary, title, tone, type, ...props }: GameStageTileProps): ReactNode;
+
+export declare interface GameStageTileProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+    badge?: string;
+    icon?: ClayIconName;
+    kicker: string;
+    selected?: boolean;
+    summary: string;
+    title: string;
+    tone?: 'daily' | 'portal' | 'host' | 'danger';
+}
+
+export declare const GameStatList: typeof GameFactList;
+
+export declare type GameStatListProps = GameFactListProps;
+
+export declare type GameSurfaceDensity = 'comfortable' | 'dense';
+
+export declare type GameSurfaceLayout = 'auto' | 'desktop' | 'mobile';
+
+export declare interface GameTabItem {
+    id: string;
+    label: string;
+}
+
+export declare function GameTabs({ activeId, onSelect, tabs }: GameTabsProps): ReactNode;
+
+export declare interface GameTabsProps {
+    activeId: string;
+    onSelect?: (id: string) => void;
+    tabs: readonly GameTabItem[];
+}
+
+export declare type GameTerrainBuildModeId = 'terrain' | 'build' | 'place' | 'inspect';
+
+export declare interface GameTerrainBuildModeOption {
+    /** Accessible label override when compact labels are used visually. */
+    ariaLabel?: string;
+    compactLabel?: string;
+    disabled?: boolean;
+    icon?: ClayIconName;
+    id: GameTerrainBuildModeId | string;
+    label: string;
+    meta?: string;
+}
+
+export declare function GameTerrainBuildToolbox({ className, drawerOpen, drawerTitle, label, onDrawerOpenChange, title, variant, 'data-testid': testId, ...bodyProps }: GameTerrainBuildToolboxProps): ReactNode;
+
+export declare interface GameTerrainBuildToolboxProps {
+    activeBuildCategoryId?: string | undefined;
+    activeMaterialId?: string | undefined;
+    activeModeId: string;
+    activeToolId: string;
+    brush: GameBrushControlState;
+    buildCategories?: readonly GameBuildCategory[] | undefined;
+    className?: string;
+    density?: GameSurfaceDensity;
+    disabled?: boolean;
+    drawerOpen?: boolean;
+    drawerTitle?: string;
+    label: string;
+    materials?: readonly GameTerrainMaterialSwatch[] | undefined;
+    modes: readonly GameTerrainBuildModeOption[];
+    onBrushRadiusChange?: ((radius: number) => void) | undefined;
+    onBrushStrengthChange?: ((strength: number) => void) | undefined;
+    onBuildCategoryChange?: ((categoryId: string) => void) | undefined;
+    onDrawerOpenChange?: ((open: boolean) => void) | undefined;
+    onMaterialChange?: ((materialId: string) => void) | undefined;
+    onModeChange?: ((modeId: string) => void) | undefined;
+    onRedo?: (() => void) | undefined;
+    onSelectBuildItem?: ((itemId: string, categoryId: string) => void) | undefined;
+    onToolChange?: ((toolId: string) => void) | undefined;
+    onUndo?: (() => void) | undefined;
+    selectedBuildItemId?: string | undefined;
+    status?: GameTerrainStatusState | undefined;
+    title: string;
+    toolCompactLabelMode?: GameTerrainToolCompactLabelMode;
+    tools: readonly GameTerrainToolOption[];
+    undoRedo?: GameUndoRedoState | undefined;
+    variant?: GameTerrainBuildVariant;
+    'data-testid'?: string | undefined;
+}
+
+export declare type GameTerrainBuildVariant = 'desktop' | 'dense' | 'mobile' | 'small-mobile';
+
+export declare type GameTerrainMaterialPattern = 'solid' | 'speckled' | 'hatched' | 'grid';
+
+export declare interface GameTerrainMaterialSwatch {
+    color: string;
+    compactLabel?: string;
+    disabled?: boolean;
+    id: string;
+    label: string;
+    meta?: string;
+    pattern?: GameTerrainMaterialPattern;
+    secondaryColor?: string;
+}
+
+export declare function GameTerrainModeControl({ activeModeId, className, disabled, label, modes, onModeChange, variant, 'data-testid': testId, }: GameTerrainModeControlProps): ReactNode;
+
+export declare interface GameTerrainModeControlProps {
+    activeModeId: string;
+    className?: string;
+    disabled?: boolean;
+    label: string;
+    modes: readonly GameTerrainBuildModeOption[];
+    onModeChange?: ((modeId: string) => void) | undefined;
+    variant?: GameTerrainBuildVariant;
+    'data-testid'?: string | undefined;
+}
+
+export declare interface GameTerrainStatusState {
+    description?: string;
+    label: string;
+    progressLabel?: string;
+    progressMax?: number;
+    progressValue?: number;
+    tone?: GameTerrainStatusTone;
+}
+
+export declare type GameTerrainStatusTone = Extract<GameBadgeTone, 'neutral' | 'success' | 'warning' | 'danger' | 'ai'>;
+
+export declare type GameTerrainToolCompactLabelMode = 'auto' | GameActionIconLabelMode;
+
+export declare type GameTerrainToolId = 'raise' | 'lower' | 'flatten' | 'smooth' | 'paint';
+
+export declare interface GameTerrainToolOption {
+    /** Accessible label override when icon/caption controls use short copy. */
+    ariaLabel?: string;
+    compactLabel?: string;
+    disabled?: boolean;
+    icon?: ClayIconName;
+    id: GameTerrainToolId | string;
+    label: string;
+    meta?: string;
+    shortcut?: string;
+}
+
+export declare function GameTerrainToolStrip({ activeToolId, className, compactLabelMode, density, disabled, label, onToolChange, tools, variant, 'data-testid': testId, }: GameTerrainToolStripProps): ReactNode;
+
+export declare interface GameTerrainToolStripProps {
+    activeToolId: string;
+    className?: string;
+    compactLabelMode?: GameTerrainToolCompactLabelMode;
+    density?: GameSurfaceDensity;
+    disabled?: boolean;
+    label: string;
+    onToolChange?: ((toolId: string) => void) | undefined;
+    tools: readonly GameTerrainToolOption[];
+    variant?: GameTerrainBuildVariant;
+    'data-testid'?: string | undefined;
+}
+
+export declare const GameTextArea: ForwardRefExoticComponent<GameTextAreaProps & RefAttributes<HTMLTextAreaElement>>;
+
+export declare interface GameTextAreaProps extends TextareaHTMLAttributes<HTMLTextAreaElement> {
+    invalid?: boolean;
+}
+
+export declare function GameToast({ children, tone }: GameToastProps): ReactNode;
+
+export declare interface GameToastProps {
+    children: ReactNode;
+    tone?: 'info' | 'success' | 'danger';
+}
+
+export declare function GameToggle({ checked, disabled, label, onClick }: GameToggleProps): ReactNode;
+
+export declare interface GameToggleProps extends Pick<ButtonHTMLAttributes<HTMLButtonElement>, 'disabled' | 'onClick'> {
+    checked: boolean;
+    label: string;
+}
+
+export declare function GameTooltip({ children, label }: GameTooltipProps): ReactNode;
+
+export declare interface GameTooltipProps {
+    children: ReactNode;
+    label: string;
+}
+
+export declare interface GameUiAction {
+    /** Accessible label override when the visible label is intentionally compact. */
+    ariaLabel?: string;
+    badge?: string;
+    /** Short visual caption for dense/icon tool strips. Falls back to `label`. */
+    compactLabel?: string;
+    disabled?: boolean;
+    icon?: ClayIconName;
+    id: string;
+    label: string;
+    meta?: string;
+    onAction?: (id: string) => void;
+    selected?: boolean;
+    shortcut?: string;
+    tone?: GameButtonVariant;
+}
+
+export declare interface GameUiHistoryEntry {
+    id: string;
+    kind: GameUiHistoryKind;
+    meta: string;
+    speaker: string;
+    text: string;
+}
+
+export declare type GameUiHistoryKind = 'human' | 'mystery' | 'system';
+
+export declare function GameUiPreview({ title, body }: GameUiPreviewProps): ReactNode;
+
+export declare interface GameUiPreviewProps {
+    title?: string;
+    body?: string;
+}
+
+export declare function GameUndoRedoActions({ canRedo, canUndo, className, disabled, label, onRedo, onUndo, redoLabel, undoLabel, variant, 'data-testid': testId, }: GameUndoRedoActionsProps): ReactNode;
+
+export declare interface GameUndoRedoActionsProps extends GameUndoRedoState {
+    className?: string;
+    disabled?: boolean;
+    label: string;
+    onRedo?: (() => void) | undefined;
+    onUndo?: (() => void) | undefined;
+    variant?: GameTerrainBuildVariant;
+    'data-testid'?: string | undefined;
+}
+
+export declare interface GameUndoRedoState {
+    canRedo?: boolean | undefined;
+    canUndo?: boolean | undefined;
+    redoLabel?: string | undefined;
+    undoLabel?: string | undefined;
+}
+
+export declare function GameWindowPanel({ allowMaximize, allowMinimize, children, className, defaultState, footer, icon, labels, onClose, onStateChange, state, title, ...props }: GameWindowPanelProps): ReactNode;
+
+export declare interface GameWindowPanelLabels {
+    close: string;
+    maximize: string;
+    minimize: string;
+    restore: string;
+}
+
+export declare interface GameWindowPanelProps extends Omit<HTMLAttributes<HTMLElement>, 'title'> {
+    /** Allow the maximize button. Defaults to true. */
+    allowMaximize?: boolean;
+    /** Allow the minimize button. Defaults to true. */
+    allowMinimize?: boolean;
+    children: ReactNode;
+    className?: string;
+    /** Uncontrolled initial state. Defaults to 'normal'. */
+    defaultState?: GameWindowState;
+    footer?: ReactNode;
+    icon?: ReactNode;
+    labels?: Partial<GameWindowPanelLabels>;
+    /** Rendering a close button requires an onClose handler. */
+    onClose?: () => void;
+    onStateChange?: (state: GameWindowState) => void;
+    /** Controlled window state. Leave undefined for uncontrolled usage. */
+    state?: GameWindowState;
+    title: string;
+}
+
+export declare type GameWindowState = 'normal' | 'minimized' | 'maximized';
+
+export declare function getClayAssetMode(): ClayAssetMode;
+
+export declare function getClayCatalogPaths(): typeof CLAY_ASSETS.catalog;
+
+export declare function getClayIconPath(icon: ClayIconName, options?: ClayIconResolveOptions): string;
+
+/** Which visual families exist for an icon (in display order: game, then line). */
+export declare function getClayIconStyles(icon: ClayIconName): ClayIconStyle[];
+
+export declare function getClaySourceAssetPath(icon: ClayIconName, style?: ClayIconStyle): string;
+
+export declare function playGameInteractionSound(options?: GameInteractionSoundOptions): boolean;
+
+export declare function playGameInteractionSoundForContext(audioContext: GameInteractionAudioContext, options?: GameInteractionSoundOptions): boolean;
+
+/**
+ * Switch how clay icons resolve globally.
+ * - 'inline' (default): zero-dependency SVG placeholders, no assets required.
+ * - 'source': the real clay game-icon PNG paths under CLAY_ASSET_BASE_PATH.
+ *   The host app must serve those assets (e.g. copy them into its public/).
+ */
+export declare function setClayAssetMode(mode: ClayAssetMode): void;
+
+export { }