@gamepark/react-game 7.7.24 → 7.7.26

package/dist/components/dialogs/ExtensionInfoDialog.js

@@ -0,0 +1,182 @@
+import { jsx as _jsx, jsxs as _jsxs } from "@emotion/react/jsx-runtime";
+/** @jsxImportSource @emotion/react */
+import { css, useTheme } from '@emotion/react';
+import { faChevronLeft } from '@fortawesome/free-solid-svg-icons/faChevronLeft';
+import { faChevronRight } from '@fortawesome/free-solid-svg-icons/faChevronRight';
+import { FontAwesomeIcon } from '@fortawesome/react-fontawesome';
+import { useCallback, useContext, useState } from 'react';
+import { useTranslation } from 'react-i18next';
+import { gameContext } from '../GameProvider';
+import { RulesDialog } from './RulesDialog';
+const isDismissed = (key) => {
+    try {
+        return sessionStorage.getItem(key) === 'true';
+    }
+    catch {
+        return false;
+    }
+};
+const markDismissed = (key) => {
+    try {
+        sessionStorage.setItem(key, 'true');
+    }
+    catch {
+        // ignore (private mode, quota, …)
+    }
+};
+/**
+ * Generic carousel-style "you are playing with extension(s)" popup.
+ *
+ * The framework handles:
+ *   - the dialog/modal wrapper (close button via `theme.dialog.closeButton`/`closeIcon`)
+ *   - a dedicated navigation bar tailored to this dialog (see ExtensionNav below):
+ *     * single popup    → just a centered "Close" button (no useless Previous/Next)
+ *     * multiple popups → Previous + dots + Next as long as we're not on the last page;
+ *                         on the last page Next becomes "Close" (still keeps Previous)
+ *   - the `sessionStorage` gate ("show once per tab session", F5-safe)
+ *
+ * The game just passes:
+ *   - `popups`: a ReactNode per extension, fully self-rendered (title, body, cards…)
+ *   - `storageKey`: a stable identifier whose composition encodes the active extension combo
+ *
+ * Pass an empty `popups` array (or omit the component) when no extension is active.
+ */
+export const ExtensionInfoDialog = ({ popups, storageKey }) => {
+    const theme = useTheme();
+    // Default storage key derives from the active game id (e.g. "faraway-extensions").
+    // The GameProvider always sets `game` in its context, so this is safe to use as a
+    // fallback when the consumer doesn't pass an explicit storageKey.
+    const { game } = useContext(gameContext);
+    const effectiveStorageKey = storageKey ?? `${game}-extensions`;
+    const [open, setOpen] = useState(() => popups.length > 0 && !isDismissed(effectiveStorageKey));
+    const [index, setIndex] = useState(0);
+    const total = popups.length;
+    const safeIndex = Math.min(Math.max(0, index), Math.max(0, total - 1));
+    const close = useCallback(() => {
+        markDismissed(effectiveStorageKey);
+        setOpen(false);
+    }, [effectiveStorageKey]);
+    if (total === 0)
+        return null;
+    /* CSS cascade for the dialog container:
+     *   1. <Dialog> applies `theme.dialog.container` automatically — that's
+     *      the game-wide chrome (background, padding, dotted outline, fonts…).
+     *      It lands by default, we don't re-apply it here.
+     *   2. `containerCss` below adds the extension-flavour defaults (sane
+     *      width / max-height for a card carousel).
+     *   3. `theme.extensionDialog.container` (if any) lands last and wins —
+     *      games override width, max-height, etc. through the theme rather
+     *      than props. Emotion's array stacking handles precedence, no flag
+     *      needed.
+     */
+    return (_jsx(RulesDialog, { open: open, close: close, css: [containerCss, theme.extensionDialog?.container], children: _jsxs("div", { css: layoutCss, children: [_jsx("div", { css: contentCss, children: popups[safeIndex] }), _jsx(ExtensionNav, { total: total, currentIndex: safeIndex, onPrevious: safeIndex > 0 ? () => setIndex(i => i - 1) : undefined, onNext: safeIndex < total - 1 ? () => setIndex(i => i + 1) : undefined, onClose: close })] }) }));
+};
+const ExtensionNav = ({ total, currentIndex, onPrevious, onNext, onClose }) => {
+    const { t } = useTranslation();
+    const theme = useTheme();
+    const primary = theme.palette.primary;
+    if (total === 1) {
+        return (_jsx("div", { css: [barCss(primary), singleSlideBarCss, theme.dialog.navigationCss], children: _jsx("button", { css: btnCss(primary), onClick: onClose, children: _jsx("span", { children: t('Close', { ns: 'common' }) }) }) }));
+    }
+    const isLast = currentIndex === total - 1;
+    return (_jsxs("div", { css: [barCss(primary), theme.dialog.navigationCss], children: [_jsxs("button", { css: btnCss(primary), onClick: onPrevious, disabled: !onPrevious, children: [_jsx(FontAwesomeIcon, { icon: faChevronLeft, css: iconCss }), _jsx("span", { children: t('Previous', { ns: 'common' }) })] }), _jsxs("div", { css: counterCss, children: [_jsx("div", { css: dotsCss, children: Array.from({ length: Math.min(total, 8) }, (_, i) => (_jsx("div", { css: [dotCss(primary), i === Math.min(currentIndex, 7) && activeDotCss(primary)] }, i))) }), _jsxs("span", { children: [currentIndex + 1, " / ", total] })] }), isLast ? (_jsx("button", { css: btnCss(primary), onClick: onClose, children: _jsx("span", { children: t('Close', { ns: 'common' }) }) })) : (_jsxs("button", { css: btnCss(primary), onClick: onNext, disabled: !onNext, children: [_jsx("span", { children: t('Next', { ns: 'common' }) }), _jsx(FontAwesomeIcon, { icon: faChevronRight, css: iconCss })] }))] }));
+};
+const containerCss = css `
+  /* Default sizing for the extension carousel — comfortably fits a 4-card
+     grid plus prose. Games widen / shrink / switch to width: auto via
+     theme.extensionDialog.container, which lands after this in the
+     Emotion cascade. */
+  width: min(90vw, 70em);
+  width: min(90dvw, 70em);
+`;
+const layoutCss = css `
+  display: flex;
+  flex-direction: column;
+  max-height: 90vh;
+  max-height: 90dvh;
+`;
+/* Same em base as the framework's help dialogs (helpDialogContentCss) so the popup body
+   reads at the same scale as the rest of the rules UI, and the navigation (its own 2.4em)
+   lands at the expected size right below. */
+const contentCss = css `
+  font-size: 2.4em;
+  overflow-y: auto;
+  padding: 0.6em 0.7em 0.5em;
+  flex: 1;
+  min-height: 0;
+`;
+/* Visual recipe copied (intentionally) from BottomBarNavigation so the
+   ExtensionNav and the standard help-dialog bottom bar feel like
+   siblings. Keep them in sync if you tweak the look on one side. */
+const barCss = (primary) => css `
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  font-size: 2.4em;
+  padding: 0.3em 1em;
+  border-top: 1px solid color-mix(in srgb, ${primary} 8%, transparent);
+  background: linear-gradient(to top, color-mix(in srgb, ${primary} 4%, transparent), transparent);
+`;
+const singleSlideBarCss = css `
+  /* Single-slide variant: just a centered Close button, no Previous/Next
+     to surround. justify-content: center collapses the bar around it. */
+  justify-content: center;
+`;
+const btnCss = (primary) => css `
+  display: flex;
+  align-items: center;
+  gap: 0.4em;
+  padding: 0.4em 0.9em;
+  border-radius: 2em;
+  font-size: 0.78em;
+  font-weight: 600;
+  font-family: inherit;
+  color: ${primary};
+  background: transparent;
+  border: 1.5px solid color-mix(in srgb, ${primary} 25%, transparent);
+  cursor: pointer;
+  transition: all 0.15s;
+
+  &:hover:not(:disabled) {
+    background: color-mix(in srgb, ${primary} 10%, transparent);
+    border-color: ${primary};
+  }
+
+  &:active:not(:disabled) {
+    background: color-mix(in srgb, ${primary} 18%, transparent);
+  }
+
+  &:disabled {
+    opacity: 0.25;
+    cursor: default;
+  }
+`;
+const iconCss = css `
+  font-size: 0.9em;
+`;
+const counterCss = css `
+  font-size: 0.75em;
+  color: inherit;
+  opacity: 0.7;
+  display: flex;
+  align-items: center;
+  gap: 0.5em;
+  font-weight: 600;
+`;
+const dotsCss = css `
+  display: flex;
+  gap: 0.3em;
+`;
+const dotCss = (primary) => css `
+  width: 0.35em;
+  height: 0.35em;
+  border-radius: 50%;
+  background: color-mix(in srgb, ${primary} 35%, transparent);
+  transition: all 0.2s;
+`;
+const activeDotCss = (primary) => css `
+  background: ${primary};
+  width: 1em;
+  border-radius: 0.2em;
+`;
+//# sourceMappingURL=ExtensionInfoDialog.js.map

package/dist/components/dialogs/ExtensionInfoDialog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExtensionInfoDialog.js","sourceRoot":"","sources":["../../../src/components/dialogs/ExtensionInfoDialog.tsx"],"names":[],"mappings":"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"}

package/dist/components/dialogs/FailuresDialog.js

@@ -65,19 +65,19 @@ const fallbackDescription = (failure) => ({
     title: (t) => t('Unknown error:'),
     text: () => failure
 });
-const aboveLoadingScreenCss = css `
-  z-index: 1600;
+const aboveLoadingScreenCss = css `
+  z-index: 1600;
 `;
-const titleCss = css `
-  display: flex;
-  align-items: center;
-  gap: 0.4em;
+const titleCss = css `
+  display: flex;
+  align-items: center;
+  gap: 0.4em;
 `;
-const iconCss = css `
-  color: #28B8CE;
+const iconCss = css `
+  color: #28B8CE;
 `;
-const inDialogButton = css `
-  margin: 0 0 0 auto;
-  font-size: 1.125em;
+const inDialogButton = css `
+  margin: 0 0 0 auto;
+  font-size: 1.125em;
 `;
 //# sourceMappingURL=FailuresDialog.js.map

package/dist/components/dialogs/index.d.ts

@@ -1,4 +1,5 @@
 export * from './RulesDialog';
 export * from './Dialog';
+export * from './ExtensionInfoDialog';
 export * from './FailuresDialog';
 export * from './ResultDialog';

package/dist/components/dialogs/index.js

@@ -1,5 +1,6 @@
 export * from './RulesDialog';
 export * from './Dialog';
+export * from './ExtensionInfoDialog';
 export * from './FailuresDialog';
 export * from './ResultDialog';
 //# sourceMappingURL=index.js.map

package/dist/components/dialogs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/dialogs/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,UAAU,CAAA;AACxB,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/dialogs/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,UAAU,CAAA;AACxB,cAAc,uBAAuB,CAAA;AACrC,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA"}

package/dist/components/material/Dices/OctahedralDiceDescription.d.ts

@@ -0,0 +1,48 @@
+/** @jsxImportSource @emotion/react */
+import { Interpolation, Theme } from '@emotion/react';
+import { MaterialItem } from '@gamepark/rules-api';
+import { ItemContext } from '../../../locators';
+import { MaterialContentProps } from '../MaterialDescription';
+import { MobileMaterialDescription } from '../MobileMaterialDescription';
+/**
+ * 8-faced (octahedral) dice with CSS 3D transforms.
+ *
+ * The `images` array must contain exactly 8 images, one per face:
+ *
+ *   - **images[0–3]**: top faces (triangles pointing up)
+ *   - **images[4–7]**: bottom faces (triangles pointing down)
+ *
+ * Within each half, faces are arranged by cardinal direction:
+ *
+ *   | Index | Half   | Direction |
+ *   |-------|--------|-----------|
+ *   |   0   |  top   |  front    |
+ *   |   1   |  top   |  right    |
+ *   |   2   |  top   |  back     |
+ *   |   3   |  top   |  left     |
+ *   |   4   | bottom |  front    |
+ *   |   5   | bottom |  right    |
+ *   |   6   | bottom |  back     |
+ *   |   7   | bottom |  left     |
+ *
+ * `location.rotation` (0–7) selects which face is shown on top.
+ * Top face images should have their symbol shifted toward the base of the triangle (centroid offset).
+ * Bottom face images should be rotated 180° with the symbol shifted the opposite way.
+ */
+export declare abstract class OctahedralDiceDescription<P extends number = number, M extends number = number, L extends number = number, ItemId = any> extends MobileMaterialDescription<P, M, L, ItemId> {
+    width: number;
+    ratio: number;
+    borderRadius: number;
+    color: string;
+    abstract images: string[] | Record<any, string[]>;
+    /** Set to true to display face index labels (0-7) for debugging */
+    debugFaceLabels: boolean;
+    private get tz();
+    getImages(): string[];
+    getDiceImages(itemId: ItemId): string[];
+    getColor(_itemId: ItemId): string;
+    content: ({ itemId, highlight, preview, playDown }: MaterialContentProps<ItemId>) => import("@emotion/react/jsx-runtime").JSX.Element;
+    getItemTransform(item: MaterialItem<P, L>, context: ItemContext<P, M, L>): string[];
+    getRotations(item: MaterialItem<P, L>, _context: ItemContext<P, M, L>): string[];
+    getHelpDisplayExtraCss(item: Partial<MaterialItem<P, L>>, context: ItemContext<P, M, L>): Interpolation<Theme>;
+}

package/dist/components/material/Dices/OctahedralDiceDescription.js

@@ -0,0 +1,142 @@
+import { jsx as _jsx, Fragment as _Fragment } from "@emotion/react/jsx-runtime";
+/** @jsxImportSource @emotion/react */
+import { css } from '@emotion/react';
+import { range } from 'es-toolkit';
+import { backgroundCss, shadowEffect, shineEffect, transformCss } from '../../../css';
+import { MobileMaterialDescription } from '../MobileMaterialDescription';
+const TILT = 35.26; // 90 - arctan(sqrt(2)) in degrees
+const TZ_RATIO = 0.2562; // translateZ / width ratio for octahedron
+/**
+ * 8-faced (octahedral) dice with CSS 3D transforms.
+ *
+ * The `images` array must contain exactly 8 images, one per face:
+ *
+ *   - **images[0–3]**: top faces (triangles pointing up)
+ *   - **images[4–7]**: bottom faces (triangles pointing down)
+ *
+ * Within each half, faces are arranged by cardinal direction:
+ *
+ *   | Index | Half   | Direction |
+ *   |-------|--------|-----------|
+ *   |   0   |  top   |  front    |
+ *   |   1   |  top   |  right    |
+ *   |   2   |  top   |  back     |
+ *   |   3   |  top   |  left     |
+ *   |   4   | bottom |  front    |
+ *   |   5   | bottom |  right    |
+ *   |   6   | bottom |  back     |
+ *   |   7   | bottom |  left     |
+ *
+ * `location.rotation` (0–7) selects which face is shown on top.
+ * Top face images should have their symbol shifted toward the base of the triangle (centroid offset).
+ * Bottom face images should be rotated 180° with the symbol shifted the opposite way.
+ */
+export class OctahedralDiceDescription extends MobileMaterialDescription {
+    width = 2;
+    ratio = 1;
+    borderRadius = 0;
+    color = '#222222';
+    /** Set to true to display face index labels (0-7) for debugging */
+    debugFaceLabels = false;
+    get tz() { return this.width * TZ_RATIO; }
+    getImages() {
+        return Array.isArray(this.images) ? this.images : Object.values(this.images).flat();
+    }
+    getDiceImages(itemId) {
+        return Array.isArray(this.images) ? this.images : this.images[itemId];
+    }
+    getColor(_itemId) {
+        return this.color;
+    }
+    content = ({ itemId, highlight, preview, playDown = preview }) => {
+        const images = this.getDiceImages(itemId);
+        const w = this.width;
+        const tz = this.tz;
+        const sideCss = css `
+      position: absolute;
+      width: ${w}em;
+      height: ${w}em;
+      backface-visibility: hidden;
+    `;
+        const diamondTopCss = css `
+      display: block;
+      width: 100%;
+      height: 100%;
+      overflow: hidden;
+      backface-visibility: hidden;
+      transform: translateY(50%) rotate(30deg) skewY(30deg) scaleX(0.866);
+      filter: drop-shadow(0 0 0.03em rgba(0, 0, 0, 0.5));
+    `;
+        const diamondBottomCss = css `
+      display: block;
+      width: 100%;
+      height: 100%;
+      overflow: hidden;
+      backface-visibility: hidden;
+      transform: translateY(-50%) rotate(30deg) skewY(30deg) scaleX(0.866);
+      filter: drop-shadow(0 0 0.03em rgba(0, 0, 0, 0.5));
+    `;
+        const contentTopCss = css `
+      display: block;
+      width: 100%;
+      height: 100%;
+      backface-visibility: hidden;
+      background-color: ${this.getColor(itemId)};
+      transform: scaleX(1.155) skewY(-30deg) rotate(-30deg) translateY(-50%);
+    `;
+        const contentBottomCss = css `
+      display: block;
+      width: 100%;
+      height: 100%;
+      backface-visibility: hidden;
+      background-color: ${this.getColor(itemId)};
+      transform: scaleX(1.155) skewY(-30deg) rotate(-30deg) translateY(50%);
+    `;
+        const faceLabelCss = this.debugFaceLabels ? css `
+      position: absolute;
+      top: 50%;
+      left: 50%;
+      transform: translate(-50%, -50%);
+      font-size: ${w * 0.3}em;
+      font-weight: bold;
+      color: red;
+      pointer-events: none;
+      z-index: 1;
+    ` : undefined;
+        return _jsx(_Fragment, { children: range(8).map((_, index) => {
+                const yRot = (index % 4) * 90;
+                // Bottom faces are offset by 180° so that rotateX(180deg) brings face N to the top
+                const bottomYRot = ((index % 4) * 90 + 180) % 360;
+                const sideTransform = index < 4
+                    ? transformCss(index > 0 ? `rotateY(${yRot}deg)` : undefined, `rotateX(${TILT}deg)`, `translateZ(${tz}em)`)
+                    : transformCss(`translateY(52%)`, bottomYRot > 0 ? `rotateY(${bottomYRot}deg)` : undefined, `rotateX(${-TILT}deg)`, `translateZ(${tz}em)`);
+                return _jsx("div", { css: [sideCss, sideTransform], children: _jsx("div", { css: index < 4 ? diamondTopCss : diamondBottomCss, children: _jsx("div", { css: [
+                                index < 4 ? contentTopCss : contentBottomCss,
+                                backgroundCss(images[index]),
+                                highlight ? shineEffect : playDown && shadowEffect
+                            ], children: faceLabelCss && _jsx("span", { css: faceLabelCss, children: index }) }) }) }, index);
+            }) });
+    };
+    getItemTransform(item, context) {
+        return super.getItemTransform(item, context).concat(`translateZ(${this.tz}em)`, ...this.getRotations(item, context));
+    }
+    getRotations(item, _context) {
+        switch (item.location.rotation) {
+            case 0: return [];
+            case 1: return ['rotateY(-90deg)'];
+            case 2: return ['rotateY(-180deg)'];
+            case 3: return ['rotateY(90deg)'];
+            case 4: return ['rotateX(180deg)'];
+            case 5: return ['rotateX(180deg)', 'rotateY(90deg)'];
+            case 6: return ['rotateX(180deg)', 'rotateY(180deg)'];
+            case 7: return ['rotateX(180deg)', 'rotateY(-90deg)'];
+            default: return [];
+        }
+    }
+    getHelpDisplayExtraCss(item, context) {
+        return item.location && [transformCss(...this.getRotations(item, context)), css `
+      margin: ${this.width / 4}em;
+    `];
+    }
+}
+//# sourceMappingURL=OctahedralDiceDescription.js.map

package/dist/components/material/Dices/OctahedralDiceDescription.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OctahedralDiceDescription.js","sourceRoot":"","sources":["../../../../src/components/material/Dices/OctahedralDiceDescription.tsx"],"names":[],"mappings":"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"}

package/dist/components/material/GameTable/DevToolEntry.d.ts

@@ -0,0 +1,17 @@
+/** @jsxImportSource @emotion/react */
+import { FC, ReactNode } from 'react';
+/**
+ * A single entry in the DevToolsHub panel.
+ * Use this instead of raw `<button>` when adding custom tools via `children`.
+ *
+ * @example
+ * <DevToolsHub>
+ *   <DevToolEntry icon="✦" label="Card Viewer" desc="Browse agents" onClick={() => setShowCards(true)} />
+ * </DevToolsHub>
+ */
+export declare const DevToolEntry: FC<{
+    icon: ReactNode;
+    label: string;
+    desc?: string;
+    onClick?: () => void;
+}>;

package/dist/components/material/GameTable/DevToolEntry.js

@@ -0,0 +1,13 @@
+import { jsx as _jsx, jsxs as _jsxs } from "@emotion/react/jsx-runtime";
+import { devToolBtnCss, devToolIconCss, devToolLabelCss, devToolDescCss } from './DevToolsStyles';
+/**
+ * A single entry in the DevToolsHub panel.
+ * Use this instead of raw `<button>` when adding custom tools via `children`.
+ *
+ * @example
+ * <DevToolsHub>
+ *   <DevToolEntry icon="✦" label="Card Viewer" desc="Browse agents" onClick={() => setShowCards(true)} />
+ * </DevToolsHub>
+ */
+export const DevToolEntry = ({ icon, label, desc, onClick }) => (_jsxs("button", { css: devToolBtnCss, onClick: onClick, children: [_jsx("span", { css: devToolIconCss, children: icon }), _jsx("span", { css: devToolLabelCss, children: label }), desc && _jsx("span", { css: devToolDescCss, children: desc })] }));
+//# sourceMappingURL=DevToolEntry.js.map

package/dist/components/material/GameTable/DevToolEntry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DevToolEntry.js","sourceRoot":"","sources":["../../../../src/components/material/GameTable/DevToolEntry.tsx"],"names":[],"mappings":";AAEA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEjG;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,YAAY,GAKpB,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CACvC,kBAAQ,GAAG,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,aAC1C,eAAM,GAAG,EAAE,cAAc,YAAG,IAAI,GAAQ,EACxC,eAAM,GAAG,EAAE,eAAe,YAAG,KAAK,GAAQ,EACzC,IAAI,IAAI,eAAM,GAAG,EAAE,cAAc,YAAG,IAAI,GAAQ,IAC1C,CACV,CAAA"}

package/dist/components/material/GameTable/DevTools/DevToolsStyles.d.ts

@@ -0,0 +1,58 @@
+export declare const GP_PRIMARY = "#28B8CE";
+export declare const GP_DARK = "#002448";
+export declare const GP_SURFACE = "#0a1929";
+export declare const GP_ACCENT = "#9fe2f7";
+export declare const fabCss: import("@emotion/utils").SerializedStyles;
+export declare const logoCss: import("@emotion/utils").SerializedStyles;
+export declare const hubContainerCss: import("@emotion/utils").SerializedStyles;
+export declare const mainMenuCss: import("@emotion/utils").SerializedStyles;
+export declare const subPanelCss: import("@emotion/utils").SerializedStyles;
+export declare const subPanelHeaderCss: import("@emotion/utils").SerializedStyles;
+export declare const subPanelTitleCss: import("@emotion/utils").SerializedStyles;
+export declare const subPanelContentCss: import("@emotion/utils").SerializedStyles;
+export declare const panelHeaderCss: import("@emotion/utils").SerializedStyles;
+export declare const headerLogoCss: import("@emotion/utils").SerializedStyles;
+export declare const panelTitleCss: import("@emotion/utils").SerializedStyles;
+export declare const panelBadgeCss: import("@emotion/utils").SerializedStyles;
+export declare const menuListCss: import("@emotion/utils").SerializedStyles;
+export declare const menuItemCss: import("@emotion/utils").SerializedStyles;
+export declare const menuItemActiveCss: import("@emotion/utils").SerializedStyles;
+export declare const menuItemIconCss: import("@emotion/utils").SerializedStyles;
+export declare const menuItemLabelCss: import("@emotion/utils").SerializedStyles;
+export declare const menuChevronCss: import("@emotion/utils").SerializedStyles;
+export declare const devToolBtnCss: import("@emotion/utils").SerializedStyles;
+export declare const toolBtnActiveCss: import("@emotion/utils").SerializedStyles;
+export declare const devToolIconCss: import("@emotion/utils").SerializedStyles;
+export declare const devToolLabelCss: import("@emotion/utils").SerializedStyles;
+export declare const devToolDescCss: import("@emotion/utils").SerializedStyles;
+export declare const activeIndicatorCss: import("@emotion/utils").SerializedStyles;
+export declare const dividerCss: import("@emotion/utils").SerializedStyles;
+export declare const inlineRowCss: import("@emotion/utils").SerializedStyles;
+export declare const stepBtnCss: import("@emotion/utils").SerializedStyles;
+export declare const numberInputCss: import("@emotion/utils").SerializedStyles;
+export declare const textInputCss: import("@emotion/utils").SerializedStyles;
+export declare const goBtnCss: import("@emotion/utils").SerializedStyles;
+export declare const playerBtnCss: import("@emotion/utils").SerializedStyles;
+export declare const playerBtnActiveCss: import("@emotion/utils").SerializedStyles;
+export declare const savedListCss: import("@emotion/utils").SerializedStyles;
+export declare const savedEntryCss: import("@emotion/utils").SerializedStyles;
+export declare const savedLabelCss: import("@emotion/utils").SerializedStyles;
+export declare const savedActionsCss: import("@emotion/utils").SerializedStyles;
+export declare const smallBtnCss: import("@emotion/utils").SerializedStyles;
+export declare const smallBtnDangerCss: import("@emotion/utils").SerializedStyles;
+export declare const backdropCss: import("@emotion/utils").SerializedStyles;
+export declare const modalBackdropCss: import("@emotion/utils").SerializedStyles;
+export declare const modalCss: import("@emotion/utils").SerializedStyles;
+export declare const modalHeaderCss: import("@emotion/utils").SerializedStyles;
+export declare const modalTitleCss: import("@emotion/utils").SerializedStyles;
+export declare const modalCloseBtnCss: import("@emotion/utils").SerializedStyles;
+export declare const modalBodyCss: import("@emotion/utils").SerializedStyles;
+export declare const modalTextareaCss: import("@emotion/utils").SerializedStyles;
+export declare const pasteErrorCss: import("@emotion/utils").SerializedStyles;
+export declare const modalFooterCss: import("@emotion/utils").SerializedStyles;
+export declare const modalCancelBtnCss: import("@emotion/utils").SerializedStyles;
+export declare const modalLoadBtnCss: import("@emotion/utils").SerializedStyles;
+export declare const flashCss: import("@emotion/utils").SerializedStyles;
+export declare const toggleRowCss: import("@emotion/utils").SerializedStyles;
+export declare const checkboxCss: import("@emotion/utils").SerializedStyles;
+export declare const toggleLabelCss: import("@emotion/utils").SerializedStyles;