import { AnchorHTMLAttributes } from 'react';
import { ButtonHTMLAttributes } from 'react';
import { ComponentType } from 'react';
import { CSSProperties } from 'react';
import { ForwardRefExoticComponent } from 'react';
import { HTMLAttributes } from 'react';
import { InputHTMLAttributes } from 'react';
import { JSX } from 'react';
import { ReactElement } from 'react';
import { ReactNode } from 'react';
import { Ref } from 'react';
import { RefAttributes } from 'react';
import { SelectHTMLAttributes } from 'react';
import { SVGProps } from 'react';
import { TextareaHTMLAttributes } from 'react';
declare type ActionElement = HTMLButtonElement | HTMLAnchorElement;
declare type ActionProps = ButtonAction | LinkAction;
declare interface BlobShape {
/** Outward bulge, in px. 0 gives the plain rounded rectangle. */
readonly amplitude: number;
/** Which shape. Same seed, same silhouette, every render. */
readonly seed?: number;
/** How many swells go round the outline. 2 is lazy, 5 is busy. */
readonly lobes?: number;
/** Rotates the swells around the outline; the knob a press animates. */
readonly phase?: number;
}
declare type ButtonAction = ButtonHTMLAttributes & {
href?: undefined;
linkComponent?: undefined;
target?: never;
download?: never;
};
declare type CornerRadii = [number, number, number, number];
declare interface EvolveOptions {
/** Spring driving the liquid mass's centre. */
massStiffness?: number;
massDamping?: number;
/** Spring driving width and height. */
sizeStiffness?: number;
sizeDamping?: number;
/** Spring driving the corner radius. */
radiusStiffness?: number;
radiusDamping?: number;
/** Maximum content cross-blur during the morph, in px. */
contentBlur?: number;
/** 0..1 droplet roundness during a shape transition. */
roundness?: number;
/** Corner-forming timeline. */
cornerDuration?: number;
cornerDelay?: number;
cornerEase?: string;
/** Ramp-in time for the droplet lead, in ms. */
anticipation?: number;
/** Maximum droplet lead toward the destination, in px. */
travel?: number;
}
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_ICON_NAMES: GameIconName[];
declare const GAME_ICONS: {
readonly ai: {
readonly name: "ai";
readonly paths: readonly ["M12 18V5", "M15 13a4.17 4.17 0 0 1-3-4 4.17 4.17 0 0 1-3 4", "M17.598 6.5A3 3 0 1 0 12 5a3 3 0 1 0-5.598 1.5", "M17.997 5.125a4 4 0 0 1 2.526 5.77", "M18 18a4 4 0 0 0 2-7.464", "M19.967 17.483A4 4 0 1 1 12 18a4 4 0 1 1-7.967-.517", "M6 18a4 4 0 0 1-2-7.464", "M6.003 5.125a4 4 0 0 0-2.526 5.77"];
};
readonly alert: {
readonly name: "alert";
readonly paths: readonly ["m21.73 18-8-14a2 2 0 0 0-3.48 0l-8 14A2 2 0 0 0 4 21h16a2 2 0 0 0 1.73-3", "M12 9v4", "M12 17h.01"];
};
readonly card: {
readonly name: "card";
readonly paths: readonly ["M4 5H20a2 2 0 0 1 2 2V17a2 2 0 0 1 -2 2H4a2 2 0 0 1 -2 -2V7a2 2 0 0 1 2 -2Z", "M2 10L22 10", "M6 14h2"];
};
readonly chat: {
readonly name: "chat";
readonly paths: readonly ["M2.992 16.342a2 2 0 0 1 .094 1.167l-1.065 3.29a1 1 0 0 0 1.236 1.168l3.413-.998a2 2 0 0 1 1.099.092 10 10 0 1 0-4.777-4.719"];
};
readonly check: {
readonly name: "check";
readonly paths: readonly ["M20 6 9 17l-5-5"];
};
readonly close: {
readonly name: "close";
readonly paths: readonly ["M18 6 6 18", "m6 6 12 12"];
};
readonly coin: {
readonly name: "coin";
readonly paths: readonly ["M13.744 17.736a6 6 0 1 1-7.48-7.48", "M15 6h1v4", "m6.134 14.768.866-.5 2 3.464", "M10 8a6 6 0 1 0 12 0a6 6 0 1 0 -12 0"];
};
readonly compass: {
readonly name: "compass";
readonly paths: readonly ["M2 12a10 10 0 1 0 20 0a10 10 0 1 0 -20 0", "m16.24 7.76-1.804 5.411a2 2 0 0 1-1.265 1.265L7.76 16.24l1.804-5.411a2 2 0 0 1 1.265-1.265z"];
};
readonly copy: {
readonly name: "copy";
readonly paths: readonly ["M10 8H20a2 2 0 0 1 2 2V20a2 2 0 0 1 -2 2H10a2 2 0 0 1 -2 -2V10a2 2 0 0 1 2 -2Z", "M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2"];
};
readonly crown: {
readonly name: "crown";
readonly paths: readonly ["M11.562 3.266a.5.5 0 0 1 .876 0L15.39 8.87a1 1 0 0 0 1.516.294L21.183 5.5a.5.5 0 0 1 .798.519l-2.834 10.246a1 1 0 0 1-.956.734H5.81a1 1 0 0 1-.957-.734L2.02 6.02a.5.5 0 0 1 .798-.519l4.276 3.664a1 1 0 0 0 1.516-.294z", "M5 21h14"];
};
readonly energy: {
readonly name: "energy";
readonly paths: readonly ["M15.914 4a1.5 1.5 0 00-2.474-1.561l-9 9A1.5 1.5 0 005.5 14h4.002a.5.5 0 01.471.666L8.086 20a1.5 1.5 0 002.475 1.56l9-9A1.5 1.5 0 0018.5 10h-3.997a.5.5 0 01-.472-.667z"];
};
readonly gem: {
readonly name: "gem";
readonly paths: readonly ["M10.5 3 8 9l4 13 4-13-2.5-6", "M17 3a2 2 0 0 1 1.6.8l3 4a2 2 0 0 1 .013 2.382l-7.99 10.986a2 2 0 0 1-3.247 0l-7.99-10.986A2 2 0 0 1 2.4 7.8l2.998-3.997A2 2 0 0 1 7 3z", "M2 9h20"];
};
readonly gift: {
readonly name: "gift";
readonly paths: readonly ["M12 7v14", "M20 11v8a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2v-8", "M7.5 7a1 1 0 0 1 0-5A4.8 8 0 0 1 12 7a4.8 8 0 0 1 4.5-5 1 1 0 0 1 0 5", "M4 7H20a1 1 0 0 1 1 1V10a1 1 0 0 1 -1 1H4a1 1 0 0 1 -1 -1V8a1 1 0 0 1 1 -1Z"];
};
readonly globe: {
readonly name: "globe";
readonly paths: readonly ["M2 12a10 10 0 1 0 20 0a10 10 0 1 0 -20 0", "M12 2a14.5 14.5 0 0 0 0 20 14.5 14.5 0 0 0 0-20", "M2 12h20"];
};
readonly history: {
readonly name: "history";
readonly paths: readonly ["M3 12a9 9 0 1 0 9-9 9.75 9.75 0 0 0-6.74 2.74L3 8", "M3 3v5h5", "M12 7v5l4 2"];
};
readonly redo: {
readonly name: "redo";
readonly paths: readonly ["M21 7v6h-6", "M3 17a9 9 0 0 1 9-9 9 9 0 0 1 6 2.3l3 2.7"];
};
readonly undo: {
readonly name: "undo";
readonly paths: readonly ["M3 7v6h6", "M21 17a9 9 0 0 0-9-9 9 9 0 0 0-6 2.3L3 13"];
};
readonly home: {
readonly name: "home";
readonly paths: readonly ["M15 21v-8a1 1 0 0 0-1-1h-4a1 1 0 0 0-1 1v8", "M3 10a2 2 0 0 1 .709-1.528l7-6a2 2 0 0 1 2.582 0l7 6A2 2 0 0 1 21 10v9a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z"];
};
readonly hourglass: {
readonly name: "hourglass";
readonly paths: readonly ["M5 22h14", "M5 2h14", "M17 22v-4.172a2 2 0 0 0-.586-1.414L12 12l-4.414 4.414A2 2 0 0 0 7 17.828V22", "M7 2v4.172a2 2 0 0 0 .586 1.414L12 12l4.414-4.414A2 2 0 0 0 17 6.172V2"];
};
readonly laurel: {
readonly name: "laurel";
readonly paths: readonly ["m15.477 12.89 1.515 8.526a.5.5 0 0 1-.81.47l-3.58-2.687a1 1 0 0 0-1.197 0l-3.586 2.686a.5.5 0 0 1-.81-.469l1.514-8.526", "M6 8a6 6 0 1 0 12 0a6 6 0 1 0 -12 0"];
};
readonly lock: {
readonly name: "lock";
readonly paths: readonly ["M5 11H19a2 2 0 0 1 2 2V20a2 2 0 0 1 -2 2H5a2 2 0 0 1 -2 -2V13a2 2 0 0 1 2 -2Z", "M7 11V7a5 5 0 0 1 10 0v4"];
};
readonly lucky: {
readonly name: "lucky";
readonly paths: readonly ["M16.17 7.83 2 22", "M4.02 12a2.827 2.827 0 1 1 3.81-4.17A2.827 2.827 0 1 1 12 4.02a2.827 2.827 0 1 1 4.17 3.81A2.827 2.827 0 1 1 19.98 12a2.827 2.827 0 1 1-3.81 4.17A2.827 2.827 0 1 1 12 19.98a2.827 2.827 0 1 1-4.17-3.81A1 1 0 1 1 4 12", "m7.83 7.83 8.34 8.34"];
};
readonly mail: {
readonly name: "mail";
readonly paths: readonly ["m22 7-8.991 5.727a2 2 0 0 1-2.009 0L2 7", "M4 4H20a2 2 0 0 1 2 2V18a2 2 0 0 1 -2 2H4a2 2 0 0 1 -2 -2V6a2 2 0 0 1 2 -2Z"];
};
readonly medal: {
readonly name: "medal";
readonly paths: readonly ["M7.21 15 2.66 7.14a2 2 0 0 1 .13-2.2L4.4 2.8A2 2 0 0 1 6 2h12a2 2 0 0 1 1.6.8l1.6 2.14a2 2 0 0 1 .14 2.2L16.79 15", "M11 12 5.12 2.2", "m13 12 5.88-9.8", "M8 7h8", "M7 17a5 5 0 1 0 10 0a5 5 0 1 0 -10 0", "M12 18v-2h-.5"];
};
readonly mission: {
readonly name: "mission";
readonly paths: readonly ["M4 22V4a1 1 0 0 1 .4-.8A6 6 0 0 1 8 2c3 0 5 2 7.333 2q2 0 3.067-.8A1 1 0 0 1 20 4v10a1 1 0 0 1-.4.8A6 6 0 0 1 16 16c-3 0-5-2-8-2a6 6 0 0 0-4 1.528"];
};
readonly mobile: {
readonly name: "mobile";
readonly paths: readonly ["M7 2H17a2 2 0 0 1 2 2V20a2 2 0 0 1 -2 2H7a2 2 0 0 1 -2 -2V4a2 2 0 0 1 2 -2Z", "M12 18h.01"];
};
readonly portal: {
readonly name: "portal";
readonly paths: readonly ["M20.341 6.484A10 10 0 0 1 10.266 21.85", "M3.659 17.516A10 10 0 0 1 13.74 2.152", "M9 12a3 3 0 1 0 6 0a3 3 0 1 0 -6 0", "M17 5a2 2 0 1 0 4 0a2 2 0 1 0 -4 0", "M3 19a2 2 0 1 0 4 0a2 2 0 1 0 -4 0"];
};
readonly scroll: {
readonly name: "scroll";
readonly paths: readonly ["M19 17V5a2 2 0 0 0-2-2H4", "M8 21h12a2 2 0 0 0 2-2v-1a1 1 0 0 0-1-1H11a1 1 0 0 0-1 1v1a2 2 0 1 1-4 0V5a2 2 0 1 0-4 0v2a1 1 0 0 0 1 1h3"];
};
readonly settings: {
readonly name: "settings";
readonly paths: readonly ["M9.671 4.136a2.34 2.34 0 0 1 4.659 0 2.34 2.34 0 0 0 3.319 1.915 2.34 2.34 0 0 1 2.33 4.033 2.34 2.34 0 0 0 0 3.831 2.34 2.34 0 0 1-2.33 4.033 2.34 2.34 0 0 0-3.319 1.915 2.34 2.34 0 0 1-4.659 0 2.34 2.34 0 0 0-3.32-1.915 2.34 2.34 0 0 1-2.33-4.033 2.34 2.34 0 0 0 0-3.831A2.34 2.34 0 0 1 6.35 6.051a2.34 2.34 0 0 0 3.319-1.915", "M9 12a3 3 0 1 0 6 0a3 3 0 1 0 -6 0"];
};
readonly shirt: {
readonly name: "shirt";
readonly paths: readonly ["M20.38 3.46 16 2a4 4 0 0 1-8 0L3.62 3.46a2 2 0 0 0-1.34 2.23l.58 3.47a1 1 0 0 0 .99.84H6v10c0 1.1.9 2 2 2h8a2 2 0 0 0 2-2V10h2.15a1 1 0 0 0 .99-.84l.58-3.47a2 2 0 0 0-1.34-2.23z"];
};
readonly shop: {
readonly name: "shop";
readonly paths: readonly ["M15 21v-5a1 1 0 0 0-1-1h-4a1 1 0 0 0-1 1v5", "M17.774 10.31a1.12 1.12 0 0 0-1.549 0 2.5 2.5 0 0 1-3.451 0 1.12 1.12 0 0 0-1.548 0 2.5 2.5 0 0 1-3.452 0 1.12 1.12 0 0 0-1.549 0 2.5 2.5 0 0 1-3.77-3.248l2.889-4.184A2 2 0 0 1 7 2h10a2 2 0 0 1 1.653.873l2.895 4.192a2.5 2.5 0 0 1-3.774 3.244", "M4 10.95V19a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2v-8.05"];
};
readonly smile: {
readonly name: "smile";
readonly paths: readonly ["M15 10V9", "M16.472 15a6 6 0 01-8.943 0", "M9 10V9", "M2 12a10 10 0 1 0 20 0a10 10 0 1 0 -20 0"];
};
readonly timer: {
readonly name: "timer";
readonly paths: readonly ["M10 2L14 2", "M12 14L15 11", "M4 14a8 8 0 1 0 16 0a8 8 0 1 0 -16 0"];
};
readonly trophy: {
readonly name: "trophy";
readonly paths: readonly ["M10 14.66V17a1 1 0 0 1-1 1 2 2 0 0 0-2 2v2", "M14 14.66V17a1 1 0 0 0 1 1 2 2 0 0 1 2 2v2", "M17.916 10H19.5A2.5 2.5 0 0 0 22 7.5V5a1 1 0 0 0-1-1h-3", "M4 22h16", "M6 9a6 6 0 0 0 12 0V3a1 1 0 0 0-1-1H7a1 1 0 0 0-1 1z", "M6.084 10H4.5A2.5 2.5 0 0 1 2 7.5V5a1 1 0 0 1 1-1h3"];
};
readonly vote: {
readonly name: "vote";
readonly paths: readonly ["m9 12 2 2 4-4", "M5 7c0-1.1.9-2 2-2h10a2 2 0 0 1 2 2v12H5V7Z", "M22 19H2"];
};
readonly 'arrow-left': {
readonly name: "arrow-left";
readonly paths: readonly ["m12 19-7-7 7-7", "M19 12H5"];
};
readonly 'arrow-right': {
readonly name: "arrow-right";
readonly paths: readonly ["M5 12h14", "m12 5 7 7-7 7"];
};
readonly 'chevron-down': {
readonly name: "chevron-down";
readonly paths: readonly ["m6 9 6 6 6-6"];
};
readonly 'chevron-up': {
readonly name: "chevron-up";
readonly paths: readonly ["m18 15-6-6-6 6"];
};
readonly download: {
readonly name: "download";
readonly paths: readonly ["M12 15V3", "M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4", "m7 10 5 5 5-5"];
};
readonly external: {
readonly name: "external";
readonly paths: readonly ["M15 3h6v6", "M10 14 21 3", "M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6"];
};
readonly menu: {
readonly name: "menu";
readonly paths: readonly ["M4 5h16", "M4 12h16", "M4 19h16"];
};
readonly minus: {
readonly name: "minus";
readonly paths: readonly ["M5 12h14"];
};
readonly moon: {
readonly name: "moon";
readonly paths: readonly ["M20.985 12.486a9 9 0 1 1-9.473-9.472c.405-.022.617.46.402.803a6 6 0 0 0 8.268 8.268c.344-.215.825-.004.803.401"];
};
readonly plus: {
readonly name: "plus";
readonly paths: readonly ["M5 12h14", "M12 5v14"];
};
readonly search: {
readonly name: "search";
readonly paths: readonly ["m21 21-4.34-4.34", "M3 11a8 8 0 1 0 16 0a8 8 0 1 0 -16 0"];
};
readonly sun: {
readonly name: "sun";
readonly paths: readonly ["M8 12a4 4 0 1 0 8 0a4 4 0 1 0 -8 0", "M12 2v2", "M12 20v2", "m4.93 4.93 1.41 1.41", "m17.66 17.66 1.41 1.41", "M2 12h2", "M20 12h2", "m6.34 17.66-1.41 1.41", "m19.07 4.93-1.41 1.41"];
};
readonly user: {
readonly name: "user";
readonly paths: readonly ["M19 21v-2a4 4 0 0 0-4-4H9a4 4 0 0 0-4 4v2", "M8 7a4 4 0 1 0 8 0a4 4 0 1 0 -8 0"];
};
};
export declare const GAME_UI_DEFAULT_STYLE: GameUiStyle;
/** Appearance and illumination are independent host choices, not component variants. */
export declare const GAME_UI_STYLES: readonly ["candy", "pastel", "mist", "grey", "outline", "ink"];
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;
};
/**
* The semantic `--game-ui-*` custom properties a *complete* theme must
* override for full fidelity — this is the same list the official
* `[data-game-ui-theme='dark']` block in theme.css satisfies, enforced by
* a guard test in src/tokens.test.ts. A downstream product building its own
* full theme (e.g. `[data-game-ui-theme='abyss']`) can reuse this constant
* to check its own CSS for the same completeness instead of eyeballing it —
* see "自定义第三主题" in design-system-guide.md for a usage example.
*/
export declare const GAME_UI_THEME_CONTRACT: readonly ["--game-ui-bg", "--game-ui-surface", "--game-ui-surface-raised", "--game-ui-surface-sunken", "--game-ui-text", "--game-ui-text-muted", "--game-ui-accent", "--game-ui-accent-bright", "--game-ui-secondary", "--game-ui-success", "--game-ui-success-bright", "--game-ui-danger", "--game-ui-danger-bright", "--game-ui-warning", "--game-ui-focus-ring", "--game-ui-border-subtle", "--game-ui-border-strong", "--game-ui-disabled", "--game-ui-ink-deep", "--game-ui-border-ink", "--game-ui-wood", "--game-ui-ink-title", "--game-ui-ink-heading"];
export declare const GAME_UI_TOKENS: {
readonly morphShape: "var(--game-ui-liquid-gooey-morph-shape)";
readonly morphSpeed: "var(--game-ui-liquid-gooey-morph-speed)";
readonly morphBounce: "var(--game-ui-liquid-gooey-morph-bounce)";
readonly evolveMassStiffness: "var(--game-ui-liquid-gooey-evolve-mass-stiffness)";
readonly evolveMassDamping: "var(--game-ui-liquid-gooey-evolve-mass-damping)";
readonly evolveSizeStiffness: "var(--game-ui-liquid-gooey-evolve-size-stiffness)";
readonly evolveSizeDamping: "var(--game-ui-liquid-gooey-evolve-size-damping)";
readonly evolveRadiusStiffness: "var(--game-ui-liquid-gooey-evolve-radius-stiffness)";
readonly evolveRadiusDamping: "var(--game-ui-liquid-gooey-evolve-radius-damping)";
readonly evolveContentBlur: "var(--game-ui-liquid-gooey-evolve-content-blur)";
readonly evolveRoundness: "var(--game-ui-liquid-gooey-evolve-roundness)";
readonly evolveCornerDuration: "var(--game-ui-liquid-gooey-evolve-corner-duration)";
readonly evolveCornerDelay: "var(--game-ui-liquid-gooey-evolve-corner-delay)";
readonly evolveCornerEase: "var(--game-ui-liquid-gooey-evolve-corner-ease)";
readonly evolveAnticipation: "var(--game-ui-liquid-gooey-evolve-anticipation)";
readonly evolveTravel: "var(--game-ui-liquid-gooey-evolve-travel)";
readonly contentBlurAreaMultiplier: "var(--game-ui-liquid-gooey-content-blur-area-multiplier)";
readonly bendVertical: "var(--game-ui-liquid-gooey-bend-vertical)";
readonly bendHorizontal: "var(--game-ui-liquid-gooey-bend-horizontal)";
readonly bendVelocityVertical: "var(--game-ui-liquid-gooey-bend-velocity-vertical)";
readonly bendVelocityHorizontal: "var(--game-ui-liquid-gooey-bend-velocity-horizontal)";
readonly bendSmoothing: "var(--game-ui-liquid-gooey-bend-smoothing)";
readonly bendActiveThreshold: "var(--game-ui-liquid-gooey-bend-active-threshold)";
readonly bendVerticalCap: "var(--game-ui-liquid-gooey-bend-vertical-cap)";
readonly bendHorizontalCap: "var(--game-ui-liquid-gooey-bend-horizontal-cap)";
readonly bendRadiusMin: "var(--game-ui-liquid-gooey-bend-radius-min)";
readonly bendRadiusMax: "var(--game-ui-liquid-gooey-bend-radius-max)";
readonly bendLeadingCapFactor: "var(--game-ui-liquid-gooey-bend-leading-cap-factor)";
readonly bendTrailingCapFactor: "var(--game-ui-liquid-gooey-bend-trailing-cap-factor)";
readonly moveStiffness: "var(--game-ui-liquid-gooey-move-stiffness)";
readonly moveDamping: "var(--game-ui-liquid-gooey-move-damping)";
readonly moveStretch: "var(--game-ui-liquid-gooey-move-stretch)";
readonly moveTail: "var(--game-ui-liquid-gooey-move-tail)";
readonly moveForce: "var(--game-ui-liquid-gooey-move-force)";
readonly moveTailSpringStiffness: "var(--game-ui-liquid-gooey-move-tail-spring-stiffness)";
readonly moveTailSpringDamping: "var(--game-ui-liquid-gooey-move-tail-spring-damping)";
readonly moveStretchSpeed: "var(--game-ui-liquid-gooey-move-stretch-speed)";
readonly moveStretchSquash: "var(--game-ui-liquid-gooey-move-stretch-squash)";
readonly moveSpeedThreshold: "var(--game-ui-liquid-gooey-move-speed-threshold)";
readonly moveTailOnsetSpeed: "var(--game-ui-liquid-gooey-move-tail-onset-speed)";
readonly moveTailOnsetRange: "var(--game-ui-liquid-gooey-move-tail-onset-range)";
readonly moveTailRamp: "var(--game-ui-liquid-gooey-move-tail-ramp)";
readonly moveTailMinRadius: "var(--game-ui-liquid-gooey-move-tail-min-radius)";
readonly moveTailWobble: "var(--game-ui-liquid-gooey-move-tail-wobble)";
readonly moveTailPhaseSpeed: "var(--game-ui-liquid-gooey-move-tail-phase-speed)";
readonly moveTailMidpointA: "var(--game-ui-liquid-gooey-move-tail-midpoint-a)";
readonly moveTailMidpointB: "var(--game-ui-liquid-gooey-move-tail-midpoint-b)";
readonly moveTailMidRadiusA: "var(--game-ui-liquid-gooey-move-tail-mid-radius-a)";
readonly moveTailMidRadiusB: "var(--game-ui-liquid-gooey-move-tail-mid-radius-b)";
readonly moveTailWobblePhase: "var(--game-ui-liquid-gooey-move-tail-wobble-phase)";
readonly moveMinPerpendicular: "var(--game-ui-liquid-gooey-move-min-perpendicular)";
readonly moveLagBase: "var(--game-ui-liquid-gooey-move-lag-base)";
readonly moveLagForce: "var(--game-ui-liquid-gooey-move-lag-force)";
readonly moveSettleDistance: "var(--game-ui-liquid-gooey-move-settle-distance)";
readonly moveSettleSpeed: "var(--game-ui-liquid-gooey-move-settle-speed)";
readonly moveIntegrationRate: "var(--game-ui-liquid-gooey-move-integration-rate)";
readonly waviness: "var(--game-ui-liquid-gooey-waviness)";
readonly wavinessFreq: "var(--game-ui-liquid-gooey-waviness-freq)";
readonly meltBlur: "var(--game-ui-liquid-gooey-melt-blur)";
readonly meltContrast: "var(--game-ui-liquid-gooey-melt-contrast)";
readonly meltReach: "var(--game-ui-liquid-gooey-melt-reach)";
readonly meltFade: "var(--game-ui-liquid-gooey-melt-fade)";
readonly meltWarp: "var(--game-ui-liquid-gooey-melt-warp)";
readonly meltMix: "var(--game-ui-liquid-gooey-melt-mix)";
readonly meltMixBlur: "var(--game-ui-liquid-gooey-melt-mix-blur)";
readonly meltGravity: "var(--game-ui-liquid-gooey-melt-gravity)";
readonly meltWaviness: "var(--game-ui-liquid-gooey-melt-waviness)";
readonly dissolveBlur: "var(--game-ui-liquid-gooey-dissolve-blur)";
readonly dissolveWarp: "var(--game-ui-liquid-gooey-dissolve-warp)";
readonly dissolvePull: "var(--game-ui-liquid-gooey-dissolve-pull)";
readonly dissolveRange: "var(--game-ui-liquid-gooey-dissolve-range)";
readonly dissolveZone: "var(--game-ui-liquid-gooey-dissolve-zone)";
readonly dissolveMix: "var(--game-ui-liquid-gooey-dissolve-mix)";
readonly dissolveGravity: "var(--game-ui-liquid-gooey-dissolve-gravity)";
readonly dissolveTaper: "var(--game-ui-liquid-gooey-dissolve-taper)";
readonly dissolveWarpFreq: "var(--game-ui-liquid-gooey-dissolve-warp-freq)";
readonly dissolveFlowSpeed: "var(--game-ui-liquid-gooey-dissolve-flow-speed)";
readonly dissolveDetail: "var(--game-ui-liquid-gooey-dissolve-detail)";
readonly dissolveReleaseMs: "var(--game-ui-liquid-gooey-dissolve-release-ms)";
readonly dissolveFadeMs: "var(--game-ui-liquid-gooey-dissolve-fade-ms)";
readonly dissolveStrength: "var(--game-ui-liquid-gooey-dissolve-strength)";
readonly dissolveSink: "var(--game-ui-liquid-gooey-dissolve-sink)";
readonly dissolveSeamBlur: "var(--game-ui-liquid-gooey-dissolve-seam-blur)";
readonly iconSm: "var(--game-ui-icon-sm)";
readonly iconMd: "var(--game-ui-icon-md)";
readonly iconLg: "var(--game-ui-icon-lg)";
readonly buttonSkinMinWidth: "var(--game-ui-asset-button-min-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 zModal: "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 shadowRaised: "var(--game-ui-shadow-raised)";
readonly stroke: "var(--game-ui-stroke)";
readonly scrollbarSize: "var(--game-ui-scrollbar-size)";
readonly scrollbarTrack: "var(--game-ui-scrollbar-track)";
readonly scrollbarThumb: "var(--game-ui-scrollbar-thumb)";
readonly scrollbarThumbHover: "var(--game-ui-scrollbar-thumb-hover)";
readonly bead: "var(--game-ui-radius-bead)";
readonly control: "var(--game-ui-radius-control)";
readonly card: "var(--game-ui-radius-card)";
readonly radiusPanel: "var(--game-ui-radius-panel)";
readonly radiusModal: "var(--game-ui-radius-modal)";
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 familyMono: "var(--game-ui-font-mono)";
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 reading: "var(--game-ui-font-reading)";
readonly lineReading: "var(--game-ui-line-reading)";
readonly measureReading: "var(--game-ui-measure-reading)";
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 surfaceSunken: "var(--game-ui-surface-sunken)";
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 GameAvatar({ className, name, size, src, status, surface, }: GameAvatarProps): ReactNode;
export declare interface GameAvatarProps {
/** Optional copper frame; omitted keeps the existing avatar surface. */
surface?: 'flat' | 'plaque';
/** 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 const GameButton: ForwardRefExoticComponent>;
export declare type GameButtonProps = ActionProps & {
children: ReactNode;
fullWidth?: boolean;
hue?: GameUiHue;
sound?: GameInteractionSoundOptions | false;
static?: boolean;
/**
* Work is running behind this action. A primary CTA breathes slowly and stays
* a full liquid CTA; other variants pulse softly. Sets `aria-busy`, never
* `disabled`: a click still reaches the product, whose own guard decides it.
* Reduced motion keeps `aria-busy` and holds still.
*/
pending?: boolean;
variant?: GameButtonVariant;
size?: 'md' | 'sm';
};
export declare type GameButtonVariant = 'primary' | 'secondary' | 'ghost' | 'danger' | 'success';
/**
* Compact product notice (wallet pitch, soft warnings, onboarding hints).
* Token-driven; products may still override cinema theme in host CSS.
*/
export declare function GameCallout({ heading, children, tone, className, style, ...props }: GameCalloutProps): ReactNode;
export declare interface GameCalloutProps extends Omit, 'title'> {
/** Visible heading (not HTML title attribute). */
readonly heading?: ReactNode;
readonly children: ReactNode;
readonly tone?: GameCalloutTone;
}
export declare type GameCalloutTone = 'neutral' | 'info' | 'warning' | 'success' | 'danger';
export declare type GameCardOrientationStatus = 'unavailable' | 'off' | 'requesting' | 'enabled' | 'denied';
/** Normalized card tilt; zero is level, -1 and 1 are the bounded extremes. */
export declare interface GameCardTilt {
readonly x: number;
readonly y: number;
}
export declare function GameCheckbox({ className, label, hue, ...props }: GameCheckboxProps): ReactNode;
export declare interface GameCheckboxProps extends Pick, 'checked' | 'defaultChecked' | 'disabled' | 'name' | 'onChange' | 'required' | 'value'> {
label: string;
className?: string;
hue?: GameUiHue;
}
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, '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;
title: string;
tone?: 'default' | 'strong';
}
/**
* A collectible card: tilts toward the pointer with a glare that follows it,
* flips on a tap, and is framed by rarity. Built for a card album where
* collecting and reviewing are the same act, but it holds nothing about
* learning: every word and picture comes from the product.
*
* Under reduced motion the card does not tilt, shine or spin its light, and a
* flip is instant.
*/
export declare function GameCollectibleCard({ rarity, title, caption, setLabel, rarityLabel, art, pips, sticker, back, label, faceDown, defaultFaceDown, onFlip, spotlight, sound, tilt: externalTilt, className, }: GameCollectibleCardProps): ReactNode;
export declare interface GameCollectibleCardProps {
readonly rarity: GameCollectibleCardRarity;
/** The card's name, large on the face. */
readonly title: string;
/** One line under the name. */
readonly caption?: string;
/** The set it belongs to, on the band at the top. */
readonly setLabel?: string;
/** The rarity's short word, in the band's chip. */
readonly rarityLabel?: string;
/** The illustration; the product supplies it. */
readonly art?: ReactNode;
/** A row of pips under the caption, such as progress toward the next rarity. */
readonly pips?: {
readonly filled: number;
readonly total: number;
};
/** A sticker on the corner, such as "NEW!". */
readonly sticker?: string;
/** The back of the card; the kit draws a plain emblem when omitted. */
readonly back?: ReactNode;
/** The full accessible name, including what a tap does. */
readonly label: string;
/** Controlled: whether the back is showing. */
readonly faceDown?: boolean;
/** Uncontrolled start. */
readonly defaultFaceDown?: boolean;
readonly onFlip?: (faceDown: boolean) => void;
/** A soft light turns behind the card: the moment the rarest card is revealed. */
readonly spotlight?: boolean;
/** Play a synthesized flip sound; browsers allow it only after the page has been tapped. */
readonly sound?: boolean;
/** Optional normalized tilt from one explicitly enabled sensor owner. A
* pointer on this card takes precedence; reduced motion always wins. */
readonly tilt?: GameCardTilt | null;
readonly className?: string;
}
/**
* How rare the card is, which is how it is framed: `common` a plain silver
* frame, `rare` a violet frame with a gem set in the top, `legendary` a gold
* frame with a crown, a foil that shifts as the card tilts and a soft light
* behind it. The product decides what earns each; the kit only draws them.
*/
export declare type GameCollectibleCardRarity = 'common' | 'rare' | 'legendary';
/** A card not collected yet: its place in the set, and what unlocks it. Not interactive. */
export declare function GameCollectibleCardSlot({ label, className, }: {
/** What unlocks it, shown on the slot and read as its name. */
readonly label: string;
readonly className?: string;
}): ReactNode;
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 flat icon shown above the title. */
icon?: GameIconName;
title: string;
description?: string;
/** Optional call-to-action node (e.g. a GameButton). */
action?: ReactNode;
className?: string;
}
export declare interface GameFactItem {
icon?: GameIconName;
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