settings-index.tsx

/*
 *  This file is part of CoCalc: Copyright © 2025 Sagemath, Inc.
 *  License: MS-RSL – see LICENSE.md for details
 */

// cSpell:ignore payg

import { Card, Divider, Flex } from "antd";
import { defineMessages, useIntl } from "react-intl";

import { redux, useTypedRedux } from "@cocalc/frontend/app-framework";
import { Icon } from "@cocalc/frontend/components";
import AIAvatar from "@cocalc/frontend/components/ai-avatar";
import { cloudFilesystemsEnabled } from "@cocalc/frontend/compute";
import { labels } from "@cocalc/frontend/i18n";
import { KUCALC_COCALC_COM } from "@cocalc/util/db-schema/site-defaults";
import { COLORS } from "@cocalc/util/theme";
import {
  VALID_PREFERENCES_SUB_TYPES,
  type NavigatePath,
  type PreferencesSubTabType,
} from "@cocalc/util/types/settings";
import { APPEARANCE_ICON_NAME } from "./account-preferences-appearance";
import { COMMUNICATION_ICON_NAME } from "./account-preferences-communication";
import { EDITOR_ICON_NAME } from "./account-preferences-editor";
import { KEYBOARD_ICON_NAME } from "./account-preferences-keyboard";
import { OTHER_ICON_NAME } from "./account-preferences-other";
import { ACCOUNT_PROFILE_ICON_NAME } from "./account-preferences-profile";
import { KEYS_ICON_NAME } from "./account-preferences-security";

const MESSAGES = defineMessages({
  title: {
    id: "account.settings.overview.title",
    defaultMessage: "Settings Overview",
  },
  profile: {
    id: "account.settings.overview.profile",
    defaultMessage:
      "Manage your personal information, avatar, and account details.",
  },
  appearance: {
    id: "account.settings.overview.appearance",
    defaultMessage:
      "Customize the visual experience via color themes, {dark_mode}, language, and visual settings.",
  },
  editor: {
    id: "account.settings.overview.editor",
    defaultMessage:
      "Customize code editor behavior, indentation, and content options.",
  },
  keyboard: {
    id: "account.settings.overview.keyboard",
    defaultMessage: "Keyboard shortcuts.",
  },
  ai: {
    id: "account.settings.overview.ai",
    defaultMessage: "Configure AI assistant settings and integrations.",
  },
  communication: {
    id: "account.settings.overview.communication",
    defaultMessage: "Notification preferences and communication settings.",
  },
  keys: {
    id: "account.settings.overview.keys",
    defaultMessage: "Manage API keys and setup SSH keys.",
  },
  other: {
    id: "account.settings.overview.other",
    defaultMessage: "Miscellaneous settings and options.",
  },
  billing: {
    id: "account.settings.overview.billing",
    defaultMessage: "Manage subscriptions, licenses, and billing information.",
  },
  subscriptions: {
    id: "account.settings.overview.subscriptions",
    defaultMessage: "View and manage your active subscriptions.",
  },
  licenses: {
    id: "account.settings.overview.licenses",
    defaultMessage: "Manage software licenses and access permissions.",
  },
  payg: {
    id: "account.settings.overview.payg",
    defaultMessage: "Configure pay-as-you-go usage and billing.",
  },
  upgrades: {
    id: "account.settings.overview.upgrades",
    defaultMessage: "Manage your legacy quota upgrades.",
  },
  purchases: {
    id: "account.settings.overview.purchases",
    defaultMessage: "View purchase history and receipts.",
  },
  payments: {
    id: "account.settings.overview.payments",
    defaultMessage: "Manage payment methods and transaction history.",
  },
  paymentMethods: {
    id: "account.settings.overview.payment_methods",
    defaultMessage: "Manage your saved payment methods or add new ones.",
  },
  statements: {
    id: "account.settings.overview.statements",
    defaultMessage: "View detailed billing statements and invoices.",
  },
  files: {
    id: "account.settings.overview.files",
    defaultMessage: "Manage published files and public sharing.",
  },
  cloud: {
    id: "account.settings.overview.cloud",
    defaultMessage: "Manage cloud file system storage.",
  },
  support: {
    id: "account.settings.overview.support",
    defaultMessage: "Access support tickets and help resources.",
  },
});

const CARD_PROPS = {
  size: "small" as const,
  hoverable: true,
  style: { width: 300, minWidth: 250 },
} as const;

// TODO: highlighting a few cards is a good idea, but better to do this later...
const HIGHLIGHTED_CARD_PROPS = CARD_PROPS; // = {
//   ...CARD_PROPS,
//   style: {
//     ...CARD_PROPS.style,
//     border: `2px solid ${COLORS.BLUE_LLL}`,
//   },
// } as const;

const FLEX_PROPS = {
  wrap: true as const,
  gap: "15px",
  style: { marginBottom: "40px" },
} as const;

export function SettingsOverview() {
  const intl = useIntl();
  const is_commercial = useTypedRedux("customize", "is_commercial");
  const kucalc = useTypedRedux("customize", "kucalc");

  function handleNavigate(path: NavigatePath) {
    // Use the same navigation pattern as the account page
    const segments = path.split("/").filter(Boolean);
    if (segments[0] === "settings") {
      if (segments[1] === "profile") {
        redux.getActions("account").setState({
          active_page: "profile",
          active_sub_tab: undefined,
        });
        redux.getActions("account").push_state(`/profile`);
      } else if (segments[1] === "preferences" && segments[2]) {
        // Handle preferences sub-tabs
        const subTab = segments[2] as PreferencesSubTabType;
        if (VALID_PREFERENCES_SUB_TYPES.includes(subTab)) {
          const subTabKey = `preferences-${subTab}` as const;
          redux.getActions("account").setState({
            active_page: "preferences",
            active_sub_tab: subTabKey,
          });
          redux.getActions("account").push_state(`/preferences/${subTab}`);
        }
      } else {
        // Handle other settings pages
        redux.getActions("account").set_active_tab(segments[1]);
        redux.getActions("account").push_state(`/${segments[1]}`);
      }
    }
  }

  return (
    <div style={{ padding: "20px" }}>
      <Flex {...FLEX_PROPS}>
        <Card
          {...HIGHLIGHTED_CARD_PROPS}
          onClick={() => handleNavigate("settings/profile")}
        >
          <Card.Meta
            avatar={<Icon name={ACCOUNT_PROFILE_ICON_NAME} />}
            title={intl.formatMessage(labels.profile)}
            description={intl.formatMessage(MESSAGES.profile)}
          />
        </Card>
        <Card
          {...HIGHLIGHTED_CARD_PROPS}
          onClick={() => handleNavigate("settings/preferences/appearance")}
        >
          <Card.Meta
            avatar={<Icon name={APPEARANCE_ICON_NAME} />}
            title={intl.formatMessage(labels.appearance)}
            description={intl.formatMessage(MESSAGES.appearance, {
              dark_mode: (
                <span
                  style={{
                    backgroundColor: COLORS.GRAY_DD,
                    color: COLORS.GRAY_LLL,
                    paddingLeft: "3px",
                    paddingRight: "3px",
                  }}
                >
                  dark mode
                </span>
              ),
            })}
          />
        </Card>
        <Card
          {...CARD_PROPS}
          onClick={() => handleNavigate("settings/preferences/editor")}
        >
          <Card.Meta
            avatar={<Icon name={EDITOR_ICON_NAME} />}
            title={intl.formatMessage(labels.editor)}
            description={intl.formatMessage(MESSAGES.editor)}
          />
        </Card>
        <Card
          {...CARD_PROPS}
          onClick={() => handleNavigate("settings/preferences/keyboard")}
        >
          <Card.Meta
            avatar={<Icon name={KEYBOARD_ICON_NAME} />}
            title={intl.formatMessage(labels.keyboard)}
            description={intl.formatMessage(MESSAGES.keyboard)}
          />
        </Card>
        <Card
          {...CARD_PROPS}
          onClick={() => handleNavigate("settings/preferences/ai")}
        >
          <Card.Meta
            avatar={<AIAvatar size={24} />}
            title={intl.formatMessage(labels.ai)}
            description={intl.formatMessage(MESSAGES.ai)}
          />
        </Card>
        <Card
          {...CARD_PROPS}
          onClick={() => handleNavigate("settings/preferences/communication")}
        >
          <Card.Meta
            avatar={<Icon name={COMMUNICATION_ICON_NAME} />}
            title={intl.formatMessage(labels.communication)}
            description={intl.formatMessage(MESSAGES.communication)}
          />
        </Card>
        <Card
          {...CARD_PROPS}
          onClick={() => handleNavigate("settings/preferences/keys")}
        >
          <Card.Meta
            avatar={<Icon name={KEYS_ICON_NAME} />}
            title={intl.formatMessage(labels.ssh_and_api_keys)}
            description={intl.formatMessage(MESSAGES.keys)}
          />
        </Card>
        <Card
          {...CARD_PROPS}
          onClick={() => handleNavigate("settings/preferences/other")}
        >
          <Card.Meta
            avatar={<Icon name={OTHER_ICON_NAME} />}
            title={intl.formatMessage(labels.other)}
            description={intl.formatMessage(MESSAGES.other)}
          />
        </Card>
      </Flex>

      {is_commercial && (
        <>
          <Divider plain>
            <Icon name="money-check" /> {intl.formatMessage(labels.billing)}
          </Divider>
          <Flex {...FLEX_PROPS}>
            <Card
              {...HIGHLIGHTED_CARD_PROPS}
              onClick={() => handleNavigate("settings/subscriptions")}
            >
              <Card.Meta
                avatar={<Icon name="calendar" />}
                title={intl.formatMessage(labels.subscriptions)}
                description={intl.formatMessage(MESSAGES.subscriptions)}
              />
            </Card>
            <Card
              {...HIGHLIGHTED_CARD_PROPS}
              onClick={() => handleNavigate("settings/licenses")}
            >
              <Card.Meta
                avatar={<Icon name="key" />}
                title={intl.formatMessage(labels.licenses)}
                description={intl.formatMessage(MESSAGES.licenses)}
              />
            </Card>
            <Card
              {...CARD_PROPS}
              onClick={() => handleNavigate("settings/payg")}
            >
              <Card.Meta
                avatar={<Icon name="line-chart" />}
                title={intl.formatMessage(labels.pay_as_you_go)}
                description={intl.formatMessage(MESSAGES.payg)}
              />
            </Card>
            {kucalc === KUCALC_COCALC_COM && (
              <Card
                {...CARD_PROPS}
                onClick={() => handleNavigate("settings/upgrades")}
              >
                <Card.Meta
                  avatar={<Icon name="arrow-circle-up" />}
                  title={intl.formatMessage(labels.upgrades)}
                  description={intl.formatMessage(MESSAGES.upgrades)}
                />
              </Card>
            )}
            <Card
              {...CARD_PROPS}
              onClick={() => handleNavigate("settings/purchases")}
            >
              <Card.Meta
                avatar={<Icon name="money-check" />}
                title={intl.formatMessage(labels.purchases)}
                description={intl.formatMessage(MESSAGES.purchases)}
              />
            </Card>
            <Card
              {...CARD_PROPS}
              onClick={() => handleNavigate("settings/payments")}
            >
              <Card.Meta
                avatar={<Icon name="credit-card" />}
                title={intl.formatMessage(labels.payments)}
                description={intl.formatMessage(MESSAGES.payments)}
              />
            </Card>
            <Card
              {...CARD_PROPS}
              onClick={() => handleNavigate("settings/payment-methods")}
            >
              <Card.Meta
                avatar={<Icon name="credit-card" />}
                title={intl.formatMessage(labels.payment_methods)}
                description={intl.formatMessage(MESSAGES.paymentMethods)}
              />
            </Card>
            <Card
              {...CARD_PROPS}
              onClick={() => handleNavigate("settings/statements")}
            >
              <Card.Meta
                avatar={<Icon name="calendar-week" />}
                title={intl.formatMessage(labels.statements)}
                description={intl.formatMessage(MESSAGES.statements)}
              />
            </Card>
          </Flex>
        </>
      )}

      <Divider plain>
        <Icon name="files" /> {intl.formatMessage(labels.files)}
      </Divider>
      <Flex {...FLEX_PROPS}>
        <Card
          {...CARD_PROPS}
          onClick={() => handleNavigate("settings/public-files")}
        >
          <Card.Meta
            avatar={<Icon name="share-square" />}
            title={intl.formatMessage(labels.published_files)}
            description={intl.formatMessage(MESSAGES.files)}
          />
        </Card>

        {cloudFilesystemsEnabled() && (
          <Card
            {...CARD_PROPS}
            onClick={() => handleNavigate("settings/cloud-filesystems")}
          >
            <Card.Meta
              avatar={<Icon name="server" />}
              title={intl.formatMessage(labels.cloud_file_system)}
              description={intl.formatMessage(MESSAGES.cloud)}
            />
          </Card>
        )}
      </Flex>

      {is_commercial && (
        <>
          <Divider plain>
            <Icon name="medkit" /> {intl.formatMessage(labels.support)}
          </Divider>
          <Flex {...FLEX_PROPS}>
            <Card
              {...CARD_PROPS}
              onClick={() => handleNavigate("settings/support")}
            >
              <Card.Meta
                avatar={<Icon name="medkit" />}
                title={intl.formatMessage(labels.support)}
                description={intl.formatMessage(MESSAGES.support)}
              />
            </Card>
          </Flex>
        </>
      )}
    </div>
  );
}