Skip to content

A reactive notebook for Python — run reproducible experiments, query with SQL, execute as a script, deploy as an app, and version with git. Stored as pure Python. All in a modern, AI-native editor.

33.2 KB
Raw Blame
/* Copyright 2026 Marimo. All rights reserved. */

import { CommandList } from "cmdk";
import { atom, useAtom, useAtomValue, useSetAtom } from "jotai";
import { atomWithStorage } from "jotai/utils";
import { PlusSquareIcon, XIcon } from "lucide-react";
import React from "react";
import { dbDisplayName } from "@/components/databases/display";
import { EngineVariable } from "@/components/databases/engine-variable";
import { DatabaseLogo } from "@/components/databases/icon";
import {
  RefreshIconButton,
  VisibilityToggleButton,
} from "@/components/editor/file-tree/tree-actions";
import { CopyClipboardIcon } from "@/components/icons/copy-icon";
import { Button, buttonVariants } from "@/components/ui/button";
import { Command, CommandInput, CommandItem } from "@/components/ui/command";
import { Tooltip } from "@/components/ui/tooltip";
import { maybeAddMarimoImport } from "@/core/cells/add-missing-import";
import { cellIdsAtom } from "@/core/cells/cells";
import { useCellActions } from "@/core/cells/actions";
import { useLastFocusedCellId } from "@/core/cells/focus";
import { autoInstantiateAtom } from "@/core/config/config";
import {
  connectionsAtom,
  type SQLTableContext,
  useDataSourceActions,
} from "@/core/datasets/data-source-connections";
import { DUCKDB_ENGINE } from "@/core/datasets/engines";
import {
  PreviewSQLSchemaList,
  PreviewSQLTable,
  PreviewSQLTableList,
} from "@/core/datasets/request-registry";
import {
  closeAllColumnsAtom,
  datasetTablesAtom,
  expandedColumnsAtom,
  useDatasets,
} from "@/core/datasets/state";
import type {
  Database,
  DatabaseSchema,
  DataSourceConnection,
  DataTable,
  DataTableColumn,
} from "@/core/kernel/messages";
import { useRequestClient } from "@/core/network/requests";
import { variablesAtom } from "@/core/variables/state";
import type { VariableName } from "@/core/variables/types";
import { useAsyncData } from "@/hooks/useAsyncData";
import { useDeepCompareMemoize } from "@/hooks/useDeepCompareMemoize";
import { sortBy } from "@/utils/arrays";
import { logNever } from "@/utils/assertNever";
import { cn } from "@/utils/cn";
import { Events } from "@/utils/events";
import { jotaiJsonStorage } from "@/utils/storage/jotai";
import {
  DatabaseIcon,
  SchemaIcon,
  TableIcon,
  ViewIcon,
} from "../databases/namespace-icons";
import { ErrorBoundary } from "../editor/boundary/ErrorBoundary";
import { PythonIcon } from "../editor/cell/code/icons";
import { useAddCodeToNewCell } from "../editor/cell/useAddCell";
import { PanelEmptyState } from "../editor/chrome/panels/empty-state";
import { AddConnectionButton } from "../editor/connections/add-connection-button";
import { DatasetColumnPreview } from "./column-preview";
import {
  ColumnName,
  DatasourceLabel,
  EmptyState,
  ErrorState,
  LoadingState,
  RotatingChevron,
} from "./components";
import {
  areChildSchemasResolved,
  areSchemasResolved,
  areTablesResolved,
  fullyQualifiedTableName,
  isSchemaless,
  schemaSubtreeMatchesSearch,
  shouldExpandDatabaseForSearch,
  sqlCode,
  tableUniqueId,
} from "./utils";

const INDENT_STEP = 1; // rem per schema nesting level (depth 0 = top-level)

// Indentation (rem) for a schema and its contents at a given nesting depth.
// Depth 0 is a top-level schema; schemaless tables/columns reuse depth 0 too.
function schemaHeaderIndentRem(depth: number): number {
  return 1.75 + depth * INDENT_STEP;
}
function schemaTableIndentRem(depth: number): number {
  return 3 + depth * INDENT_STEP;
}
function schemaColumnIndentRem(depth: number): number {
  return 3.25 + depth * INDENT_STEP;
}

// Left indentation (rem) for each fixed (non-nested) level of the tree.
const INDENT = {
  engineEmpty: 0.75,
  engine: 0.75,
  database: 1,
  tableLoading: 2.75,
  tableSchemaless: 2,
  columnLocal: 1.25,
  columnPreview: 2.5,
};

function indentStyle(rem: number): React.CSSProperties {
  return { paddingLeft: `${rem}rem` };
}

const sortedTablesAtom = atom((get) => {
  const tables = get(datasetTablesAtom);
  const variables = get(variablesAtom);
  const cellIds = get(cellIdsAtom);

  // Sort tables by the index of the variable they are defined in
  return sortBy(tables, (table) => {
    // Put at the top
    if (!table.variable_name) {
      return -1;
    }
    const variable = Object.values(variables).find(
      (v) => v.name === table.variable_name,
    );
    if (!variable) {
      return 0;
    }

    const index = cellIds.indexOf(variable.declaredBy[0]);
    if (index === -1) {
      return 0;
    }
    return index;
  });
});

/**
 * Whether to hide empty schemas and databases (those with no tables) in the
 * datasources panel.
 */
export const hideEmptyDatasourcesAtom = atomWithStorage<boolean>(
  "marimo:datasources:hideEmpty",
  false,
  jotaiJsonStorage,
  { getOnInit: true },
);

/**
 * Recursively hide schemas confirmed empty (no tables and no visible child
 * schemas). Deferred schemas are kept so the user can expand them.
 */
function filterEmptySchemas(schemas: DatabaseSchema[]): DatabaseSchema[] {
  let changed = false;
  const result: DatabaseSchema[] = [];
  for (const schema of schemas) {
    if (!areTablesResolved(schema) || !areChildSchemasResolved(schema)) {
      result.push(schema);
      continue;
    }
    const childSchemas = schema.child_schemas ?? [];
    const visibleChildren = filterEmptySchemas(childSchemas);
    if (schema.tables.length === 0 && visibleChildren.length === 0) {
      changed = true;
      continue;
    }
    if (visibleChildren === childSchemas) {
      result.push(schema);
      continue;
    }
    changed = true;
    result.push({ ...schema, child_schemas: visibleChildren });
  }
  return changed ? result : schemas;
}

/**
 * Apply the "hide empty" filter to a connection's databases.
 *
 * - Schemas with confirmed-empty table lists (and no child schemas) are
 *   hidden, recursively.
 * - Databases are hidden when either (a) their schemas have been enumerated
 *   and the list is empty, or (b) every schema in them was hidden by the
 *   schema-level filter.
 * - Databases / schemas whose contents haven't been resolved yet (deferred
 *   discovery — `schemas_resolved === false` or `tables_resolved === false`)
 *   are preserved so the user can expand them to trigger a fetch.
 */
export function filterEmptyDatabases(databases: Database[]): Database[] {
  let changed = false;
  const result: Database[] = [];
  for (const database of databases) {
    // Known-empty database: schema list was enumerated and is empty.
    if (areSchemasResolved(database) && database.schemas.length === 0) {
      changed = true;
      continue;
    }
    // Deferred schema discovery — keep so the user can expand and load.
    if (database.schemas.length === 0) {
      result.push(database);
      continue;
    }
    const visibleSchemas = filterEmptySchemas(database.schemas);
    if (visibleSchemas.length === 0) {
      changed = true;
      continue;
    }
    if (visibleSchemas === database.schemas) {
      result.push(database);
      continue;
    }
    changed = true;
    result.push({ ...database, schemas: visibleSchemas });
  }
  return changed ? result : databases;
}

export const DataSources: React.FC = () => {
  const [searchValue, setSearchValue] = React.useState<string>("");
  const [hideEmpty, setHideEmpty] = useAtom(hideEmptyDatasourcesAtom);

  const closeAllColumns = useSetAtom(closeAllColumnsAtom);
  const tables = useAtomValue(sortedTablesAtom);
  const rawConnections = useAtomValue(connectionsAtom);

  const dataConnections = React.useMemo(() => {
    if (!hideEmpty) {
      return rawConnections;
    }
    let changed = false;
    const filtered = rawConnections.map((connection) => {
      const databases = filterEmptyDatabases(connection.databases);
      if (databases === connection.databases) {
        return connection;
      }
      changed = true;
      return { ...connection, databases };
    });
    return changed ? filtered : rawConnections;
  }, [rawConnections, hideEmpty]);

  if (tables.length === 0 && dataConnections.length === 0) {
    return (
      <PanelEmptyState
        title="No tables found"
        description="Any datasets/dataframes in the global scope will be shown here."
        action={
          <AddConnectionButton
            group="database"
            label="Add database or catalog"
            variant="outline"
            size="sm"
          />
        }
        icon={<DatabaseIcon />}
      />
    );
  }

  const hasSearch = !!searchValue.trim();

  return (
    <Command
      className="border-b bg-background rounded-none h-full pb-10 overflow-auto outline-hidden"
      shouldFilter={false}
    >
      <div className="flex items-center w-full border-b">
        <CommandInput
          placeholder="Search tables..."
          className="h-6 m-1"
          value={searchValue}
          onValueChange={(value) => {
            // If searching, remove open previews
            closeAllColumns(value.length > 0);
            setSearchValue(value);
          }}
          rootClassName="flex-1 border-r border-b-0"
        />
        {hasSearch && (
          <button
            type="button"
            aria-label="Clear table search"
            className="float-right border-b px-2 m-0 h-full hover:bg-accent hover:text-accent-foreground"
            onClick={() => setSearchValue("")}
          >
            <XIcon className="h-4 w-4" />
          </button>
        )}

        <VisibilityToggleButton
          data-testid="datasources-hide-empty-button"
          isVisible={!hideEmpty}
          onToggle={() => setHideEmpty(!hideEmpty)}
          showTooltip="Show empty schemas and databases"
          hideTooltip="Hide empty schemas and databases"
          size="sm"
          className="px-2 rounded-none focus-visible:outline-hidden"
        />

        <AddConnectionButton
          group="database"
          label="Add database or catalog"
          compact={true}
          variant="ghost"
          size="sm"
          className="px-2 rounded-none focus-visible:outline-hidden"
        />
      </div>

      <CommandList className="flex flex-col">
        {dataConnections.map((connection) => (
          <Engine
            key={connection.name}
            connection={connection}
            hasChildren={connection.databases.length > 0}
          >
            {connection.databases.map((database) => (
              <DatabaseTree
                key={database.name}
                connection={connection}
                database={database}
                searchValue={searchValue}
              />
            ))}
          </Engine>
        ))}

        {dataConnections.length > 0 && tables.length > 0 && (
          <DatasourceLabel className="pr-2" style={indentStyle(INDENT.engine)}>
            <PythonIcon className="h-4 w-4 text-muted-foreground" />
            <span className="text-xs">Python</span>
          </DatasourceLabel>
        )}
        {tables.length > 0 && (
          <TableList tables={tables} searchValue={searchValue} />
        )}
      </CommandList>
    </Command>
  );
};

const Engine: React.FC<{
  connection: DataSourceConnection;
  children: React.ReactNode;
  hasChildren?: boolean;
}> = ({ connection, children, hasChildren }) => {
  // The internal duckdb connection is updated automatically, so we do not need to refresh.
  const internalEngine = connection.name === DUCKDB_ENGINE;
  const engineName = internalEngine ? "In-Memory" : connection.name;
  const { previewDataSourceConnection } = useRequestClient();

  const handleRefreshConnection = async () => {
    await previewDataSourceConnection({
      engine: connection.name,
    });
  };

  return (
    <>
      <DatasourceLabel className="pr-2" style={indentStyle(INDENT.engine)}>
        <DatabaseLogo
          className="h-4 w-4 text-muted-foreground"
          name={connection.dialect}
        />
        <span className="text-xs">{dbDisplayName(connection.dialect)}</span>
        <span className="text-xs text-muted-foreground">
          (<EngineVariable variableName={engineName as VariableName} />)
        </span>
        {!internalEngine && (
          <RefreshIconButton
            onClick={handleRefreshConnection}
            tooltip="Refresh connection"
            className="ml-auto h-4 p-0"
            iconClassName="h-3.5 w-3.5"
          />
        )}
      </DatasourceLabel>
      {hasChildren ? (
        children
      ) : (
        <EmptyState
          content="No databases available"
          style={indentStyle(INDENT.engineEmpty)}
        />
      )}
    </>
  );
};

interface DataSourceTree {
  defaultSchema?: string | null;
  defaultDatabase?: string | null;
  dialect: string;
  engineName: string;
  databaseName: string;
  searchValue?: string;
}

const DataSourceTreeContext = React.createContext<DataSourceTree | null>(null);

function useDataSourceTree(): DataSourceTree {
  const tree = React.useContext(DataSourceTreeContext);
  if (tree == null) {
    throw new Error(
      "useDataSourceTree must be used within a DataSourceTreeContext.Provider",
    );
  }
  return tree;
}

// Build the table context for a (possibly schemaless) schema
function buildSqlTableContext(
  tree: DataSourceTree,
  { schema, schemaPath }: { schema: string; schemaPath: string[] },
): SQLTableContext {
  return {
    engine: tree.engineName,
    database: tree.databaseName,
    schema,
    schemaPath,
    defaultSchema: tree.defaultSchema,
    defaultDatabase: tree.defaultDatabase,
    dialect: tree.dialect,
  };
}

const DatabaseTree: React.FC<{
  connection: DataSourceConnection;
  database: Database;
  searchValue?: string;
}> = ({ connection, database, searchValue }) => {
  const tree = React.useMemo<DataSourceTree>(
    () => ({
      engineName: connection.name,
      databaseName: database.name,
      dialect: connection.dialect,
      defaultSchema: connection.default_schema,
      defaultDatabase: connection.default_database,
      searchValue,
    }),
    [
      connection.name,
      connection.dialect,
      connection.default_schema,
      connection.default_database,
      database.name,
      searchValue,
    ],
  );

  return (
    <DatabaseItem
      engineName={connection.name}
      database={database}
      searchValue={searchValue}
    >
      <DataSourceTreeContext.Provider value={tree}>
        <SchemaList
          schemas={database.schemas}
          schemasResolved={areSchemasResolved(database)}
          schemaPath={[]}
          depth={0}
        />
      </DataSourceTreeContext.Provider>
    </DatabaseItem>
  );
};

const DatabaseItem: React.FC<{
  searchValue?: string;
  engineName: string;
  database: Database;
  children: React.ReactNode;
}> = ({ searchValue, engineName, database, children }) => {
  // Auto-expand during search only when a loaded schema under this database
  // contains a matching table.
  const expandForSearch = shouldExpandDatabaseForSearch(database, searchValue);
  const [isExpanded, setIsExpanded] = React.useState(expandForSearch);
  const [isSelected, setIsSelected] = React.useState(false);
  const [prevSearchValue, setPrevSearchValue] = React.useState(searchValue);
  const [prevExpandForSearch, setPrevExpandForSearch] =
    React.useState(expandForSearch);

  // Re-sync when the query changes or when newly resolved data turns this
  // branch into a match under the same query (deferred subtrees resolve
  // asynchronously, so the decision can flip without the query changing).
  if (
    prevSearchValue !== searchValue ||
    prevExpandForSearch !== expandForSearch
  ) {
    setPrevSearchValue(searchValue);
    setPrevExpandForSearch(expandForSearch);
    setIsExpanded(expandForSearch);
  }

  return (
    <>
      <CommandItem
        className="text-sm flex flex-row gap-1 items-center cursor-pointer rounded-none"
        style={indentStyle(INDENT.database)}
        onSelect={() => {
          setIsExpanded(!isExpanded);
          setIsSelected(!isSelected);
        }}
        value={`${engineName}:${database.name}`}
      >
        <RotatingChevron isExpanded={isExpanded} />
        <DatabaseIcon
          className={cn(
            "h-4 w-4",
            isSelected && isExpanded
              ? "text-foreground"
              : "text-muted-foreground",
          )}
        />
        <span className={cn(isSelected && isExpanded && "font-semibold")}>
          {database.name === "" ? <i>Not connected</i> : database.name}
        </span>
      </CommandItem>
      {isExpanded && children}
    </>
  );
};

interface SchemaListProps {
  schemas: DatabaseSchema[];
  schemasResolved: boolean;
  // Parent schema path (relative to the database). Empty at the top level.
  schemaPath: string[];
  // Nesting depth (0 = top-level).
  depth: number;
}

const SchemaList: React.FC<SchemaListProps> = (props) => {
  const { schemas, schemasResolved, depth } = props;
  const tree = useDataSourceTree();
  const { engineName, databaseName, searchValue } = tree;
  const { addSchemaList } = useDataSourceActions();
  // Stable identity so the useAsyncData below doesn't refire each render.
  const schemaPath = useDeepCompareMemoize(props.schemaPath);

  // Custom loading state, we need to wait for the data to propagate once requested
  // useAsyncData's loading state may return false before data has propagated
  const [schemasLoading, setSchemasLoading] = React.useState(false);

  const { isPending, error } = useAsyncData(async () => {
    if (!schemasResolved && engineName) {
      setSchemasLoading(true);
      try {
        const previewSchemaList = await PreviewSQLSchemaList.request({
          engine: engineName,
          database: databaseName,
          schemaPath: schemaPath,
        });

        addSchemaList({
          schemas: previewSchemaList.schemas ?? [],
          sqlSchemaContext: {
            engine: engineName,
            database: databaseName,
            schemaPath: schemaPath,
          },
        });
      } finally {
        setSchemasLoading(false);
      }
    }
  }, [schemasResolved, engineName, databaseName, schemaPath]);

  const stateStyle = indentStyle(schemaHeaderIndentRem(depth));

  if (isPending || schemasLoading) {
    return <LoadingState message="Loading schemas..." style={stateStyle} />;
  }

  if (error) {
    return <ErrorState error={error} style={stateStyle} />;
  }

  if (schemas.length === 0) {
    return <EmptyState content="No schemas available" style={stateStyle} />;
  }

  return (
    <>
      {schemas.map((schema) => {
        // Schemaless schemas (the database's own tables) render their tables
        // directly under the database with no expandable node.
        if (isSchemaless(schema.name)) {
          return (
            <TableList
              key={schema.name}
              tables={schema.tables}
              tablesResolved={areTablesResolved(schema)}
              searchValue={searchValue}
              sqlTableContext={buildSqlTableContext(tree, {
                schema: schema.name,
                schemaPath,
              })}
            />
          );
        }
        return (
          <SchemaNode
            key={schema.name}
            schema={schema}
            schemaPath={[...schemaPath, schema.name]}
            depth={depth}
          />
        );
      })}
    </>
  );
};

interface SchemaNodeProps {
  schema: DatabaseSchema;
  // Path of this schema relative to the database (includes this node).
  schemaPath: string[];
  depth: number;
}

const SchemaNode: React.FC<SchemaNodeProps> = (props) => {
  const { schema, schemaPath, depth } = props;
  const tree = useDataSourceTree();
  const { databaseName, searchValue } = tree;
  // Auto-expand during search only when this schema's loaded subtree contains a
  // matching table.
  const expandForSearch = schemaSubtreeMatchesSearch(schema, searchValue);
  const [isExpanded, setIsExpanded] = React.useState(expandForSearch);
  const [isSelected, setIsSelected] = React.useState(false);
  const [prevSearchValue, setPrevSearchValue] = React.useState(searchValue);
  const [prevExpandForSearch, setPrevExpandForSearch] =
    React.useState(expandForSearch);
  const uniqueValue = JSON.stringify(["schema", databaseName, ...schemaPath]);
  const childSchemas = schema.child_schemas ?? [];

  // Re-sync when the query changes or when newly resolved data turns this
  // subtree into a match under the same query (deferred tables/child schemas
  // resolve asynchronously, so the decision can flip without the query changing).
  if (
    prevSearchValue !== searchValue ||
    prevExpandForSearch !== expandForSearch
  ) {
    setPrevSearchValue(searchValue);
    setPrevExpandForSearch(expandForSearch);
    setIsExpanded(expandForSearch);
  }

  return (
    <>
      <CommandItem
        className="text-sm flex flex-row gap-1 items-center cursor-pointer rounded-none"
        style={indentStyle(schemaHeaderIndentRem(depth))}
        onSelect={() => {
          setIsExpanded(!isExpanded);
          setIsSelected(!isSelected);
        }}
        value={uniqueValue}
      >
        <RotatingChevron isExpanded={isExpanded} />
        <SchemaIcon
          className={cn(
            "h-4 w-4 text-muted-foreground",
            isSelected && isExpanded && "text-foreground",
          )}
        />
        <span className={cn(isSelected && isExpanded && "font-semibold")}>
          {schema.name}
        </span>
      </CommandItem>
      {isExpanded && (
        <>
          {/* Nested child schemas */}
          {(childSchemas.length > 0 || !areChildSchemasResolved(schema)) && (
            <SchemaList
              schemas={childSchemas}
              schemasResolved={areChildSchemasResolved(schema)}
              schemaPath={schemaPath}
              depth={depth + 1}
            />
          )}
          {/* Tables that live directly in this schema */}
          <TableList
            tables={schema.tables}
            tablesResolved={areTablesResolved(schema)}
            searchValue={searchValue}
            tableIndentRem={schemaTableIndentRem(depth)}
            columnIndentRem={schemaColumnIndentRem(depth)}
            sqlTableContext={buildSqlTableContext(tree, {
              schema: schema.name,
              schemaPath,
            })}
          />
        </>
      )}
    </>
  );
};

// Kept outside the component because the React Compiler does not yet
// support try/finally inside component bodies.
async function loadTableList(
  sqlTableContext: SQLTableContext,
  addTableList: ReturnType<typeof useDataSourceActions>["addTableList"],
  setLoading: (loading: boolean) => void,
) {
  setLoading(true);
  try {
    const { engine, database, schema, schemaPath } = sqlTableContext;
    const previewTableList = await PreviewSQLTableList.request({
      engine: engine,
      database: database,
      schema: schema,
      schemaPath: schemaPath ?? [],
    });

    if (!previewTableList?.tables) {
      throw new Error("No tables available");
    }

    addTableList({
      tables: previewTableList.tables,
      sqlTableContext: sqlTableContext,
    });
  } finally {
    setLoading(false);
  }
}

/**
 * This is exported for testing purposes only.
 */
export const TableList: React.FC<{
  tables: DataTable[];
  sqlTableContext?: SQLTableContext;
  searchValue?: string;
  // Whether `tables` has been enumerated; when false, discovery is deferred and
  // a request is issued on mount (i.e. when the parent is expanded).
  tablesResolved?: boolean;
  // Depth-based indentation (rem) for nested schema tables/columns. When
  // omitted, the fixed INDENT levels are used (top-level / schemaless tables).
  tableIndentRem?: number;
  columnIndentRem?: number;
}> = ({
  tables,
  sqlTableContext,
  searchValue,
  tablesResolved = true,
  tableIndentRem,
  columnIndentRem,
}) => {
  const { addTableList } = useDataSourceActions();

  // Custom loading state, we need to wait for the data to propagate once requested
  // useAsyncData's loading state may return false before data has propagated
  const [tablesLoading, setTablesLoading] = React.useState(false);

  // Fetch when discovery is deferred (also re-fetches after a refresh, which
  // resets tablesResolved to false).
  const { isPending, error } = useAsyncData(async () => {
    if (!tablesResolved && sqlTableContext) {
      await loadTableList(sqlTableContext, addTableList, setTablesLoading);
    }
  }, [tablesResolved, sqlTableContext]);

  const stateStyle = indentStyle(tableIndentRem ?? INDENT.tableLoading);

  if (isPending || tablesLoading) {
    return <LoadingState message="Loading tables..." style={stateStyle} />;
  }

  if (error) {
    return <ErrorState error={error} style={stateStyle} />;
  }

  if (tables.length === 0) {
    return <EmptyState content="No tables found" style={stateStyle} />;
  }

  const filteredTables = tables.filter((table) => {
    if (searchValue) {
      return table.name.toLowerCase().includes(searchValue.toLowerCase());
    }
    return true;
  });

  return (
    <>
      {filteredTables.map((table) => (
        <DatasetTableItem
          key={table.name}
          table={table}
          sqlTableContext={sqlTableContext}
          isSearching={!!searchValue}
          tableIndentRem={tableIndentRem}
          columnIndentRem={columnIndentRem}
        />
      ))}
    </>
  );
};

const DatasetTableItem: React.FC<{
  table: DataTable;
  sqlTableContext?: SQLTableContext;
  isSearching: boolean;
  tableIndentRem?: number;
  columnIndentRem?: number;
}> = ({
  table,
  sqlTableContext,
  isSearching,
  tableIndentRem,
  columnIndentRem,
}) => {
  const { addTable } = useDataSourceActions();

  const [isExpanded, setIsExpanded] = React.useState(false);
  const tableDetailsExist = table.columns.length > 0;

  const { isFetching, isPending, error } = useAsyncData(async () => {
    if (isExpanded && !tableDetailsExist && sqlTableContext) {
      const { engine, database, schema, schemaPath } = sqlTableContext;
      const previewTable = await PreviewSQLTable.request({
        engine: engine,
        database: database,
        schema: schema,
        tableName: table.name,
        schemaPath: schemaPath ?? [],
      });

      if (!previewTable?.table) {
        throw new Error("No table details available");
      }

      addTable({
        table: previewTable.table,
        sqlTableContext: sqlTableContext,
      });
    }
  }, [isExpanded, tableDetailsExist]);

  const autoInstantiate = useAtomValue(autoInstantiateAtom);
  const lastFocusedCellId = useLastFocusedCellId();
  const { createCell } = useCellActions();
  const addCodeToNewCell = useAddCodeToNewCell();

  const handleAddTable = () => {
    maybeAddMarimoImport({
      autoInstantiate,
      createCell,
      fromCellId: lastFocusedCellId,
    });
    const getCode = () => {
      if (table.source_type === "catalog") {
        // Build the fully-qualified, dotted name including any nested
        // schema path, e.g. `top.nested.table`.
        const identifier = sqlTableContext?.database
          ? [
              sqlTableContext.database,
              ...(sqlTableContext.schemaPath ?? []),
              table.name,
            ].join(".")
          : table.name;
        return `${table.engine}.load_table("${identifier}")`;
      }

      if (sqlTableContext) {
        return sqlCode({ table, columnName: "*", sqlTableContext });
      }

      switch (table.source_type) {
        case "local":
          return `mo.ui.table(${table.name})`;
        case "duckdb":
        case "connection":
          return sqlCode({ table, columnName: "*", sqlTableContext });
        default:
          logNever(table.source_type);
          return "";
      }
    };

    addCodeToNewCell(getCode());
  };

  const renderRowsByColumns = () => {
    const label: string[] = [];
    if (table.num_rows != null) {
      label.push(`${table.num_rows} rows`);
    }
    if (table.num_columns != null) {
      label.push(`${table.num_columns} columns`);
    }

    if (label.length === 0) {
      return null;
    }

    return (
      <div className="flex flex-row gap-2 items-center pl-6 group-hover:hidden">
        <span className="text-xs text-muted-foreground">
          {label.join(", ")}
        </span>
      </div>
    );
  };

  const renderColumns = () => {
    const stateStyle = indentStyle(columnIndentRem ?? INDENT.tableLoading);

    if (isPending || isFetching) {
      return <LoadingState message="Loading columns..." style={stateStyle} />;
    }

    if (error) {
      return <ErrorState error={error} style={stateStyle} />;
    }

    const columns = table.columns;

    if (columns.length === 0) {
      return <EmptyState content="No columns found" style={stateStyle} />;
    }

    return columns.map((column) => (
      <DatasetColumnItem
        key={column.name}
        table={table}
        column={column}
        sqlTableContext={sqlTableContext}
        columnIndentRem={columnIndentRem}
      />
    ));
  };

  const renderTableType = () => {
    if (table.source_type === "local") {
      return;
    }

    const TableTypeIcon = table.type === "table" ? TableIcon : ViewIcon;
    return (
      <TableTypeIcon
        className="h-3 w-3"
        strokeWidth={isExpanded || isSearching ? 2.5 : undefined}
      />
    );
  };

  const uniqueId = tableUniqueId(sqlTableContext, table.name);

  const tableRem =
    tableIndentRem ?? (sqlTableContext ? INDENT.tableSchemaless : 0);

  return (
    <>
      <CommandItem
        className={cn(
          "rounded-none group h-8 cursor-pointer",
          (isExpanded || isSearching) && "font-semibold",
        )}
        style={indentStyle(tableRem)}
        value={uniqueId}
        aria-selected={isExpanded}
        forceMount={true}
        onSelect={() => setIsExpanded(!isExpanded)}
      >
        <div className="flex gap-2 items-center flex-1 pl-1">
          {renderTableType()}
          <span className="text-sm">{table.name}</span>
        </div>
        {renderRowsByColumns()}
        <Tooltip content="Add table to notebook" delayDuration={400}>
          <Button
            aria-label={`Add table ${table.name} to notebook`}
            className="group-hover:inline-flex hidden"
            variant="text"
            size="icon"
            onClick={Events.stopPropagation(() => handleAddTable())}
          >
            <PlusSquareIcon className="h-3 w-3" />
          </Button>
        </Tooltip>
      </CommandItem>
      {isExpanded && renderColumns()}
    </>
  );
};

const DatasetColumnItem: React.FC<{
  table: DataTable;
  column: DataTableColumn;
  sqlTableContext?: SQLTableContext;
  columnIndentRem?: number;
}> = ({ table, column, sqlTableContext, columnIndentRem }) => {
  const [isExpanded, setIsExpanded] = React.useState(false);
  const closeAllColumns = useAtomValue(closeAllColumnsAtom);
  const setExpandedColumns = useSetAtom(expandedColumnsAtom);

  if (closeAllColumns && isExpanded) {
    setIsExpanded(false);
  }

  if (isExpanded) {
    setExpandedColumns(
      (prev) => new Set([...prev, `${table.name}:${column.name}`]),
    );
  } else {
    setExpandedColumns((prev) => {
      prev.delete(`${table.name}:${column.name}`);
      return new Set(prev);
    });
  }

  const addCodeToNewCell = useAddCodeToNewCell();

  const { columnsPreviews } = useDatasets();
  const isPrimaryKey = table.primary_keys?.includes(column.name) || false;
  const isIndexed = table.indexes?.includes(column.name) || false;

  const handleAddColumn = (chartCode: string) => {
    addCodeToNewCell(chartCode);
  };

  const renderItemSubtext = ({
    tooltipContent,
    content,
  }: {
    tooltipContent: string;
    content: string;
  }) => {
    return (
      <Tooltip content={tooltipContent} delayDuration={100}>
        <span className="text-xs text-black bg-gray-100 dark:invert rounded px-1">
          {content}
        </span>
      </Tooltip>
    );
  };

  const columnText = (
    <span className={isExpanded ? "font-semibold" : ""}>{column.name}</span>
  );

  return (
    <>
      <CommandItem
        className="rounded-none py-1 group cursor-pointer"
        key={`${table.name}.${column.name}`}
        value={`${table.name}.${column.name}`}
        onSelect={() => setIsExpanded(!isExpanded)}
      >
        <div
          className="flex flex-row gap-2 items-center flex-1"
          style={indentStyle(
            columnIndentRem ??
              (sqlTableContext ? schemaColumnIndentRem(0) : INDENT.columnLocal),
          )}
        >
          <ColumnName columnName={columnText} dataType={column.type} />
          {isPrimaryKey &&
            renderItemSubtext({ tooltipContent: "Primary key", content: "PK" })}
          {isIndexed &&
            renderItemSubtext({ tooltipContent: "Indexed", content: "IDX" })}
        </div>
        <CopyClipboardIcon
          tooltip="Copy column name"
          value={column.name}
          ariaLabel={`Copy column name ${column.name}`}
          className="h-3 w-3"
          buttonClassName={cn(
            buttonVariants({ variant: "text", size: "icon" }),
            "group-hover:opacity-100 opacity-0 hover:bg-muted text-muted-foreground hover:text-foreground",
          )}
        />
        <span className="text-xs text-muted-foreground">
          {column.external_type}
        </span>
      </CommandItem>
      {isExpanded && (
        <div
          className="pr-2 py-2 bg-(--slate-1) shadow-inner border-b"
          style={indentStyle(INDENT.columnPreview)}
        >
          <ErrorBoundary>
            <DatasetColumnPreview
              table={table}
              column={column}
              onAddColumnChart={handleAddColumn}
              preview={columnsPreviews.get(
                `${fullyQualifiedTableName(sqlTableContext, table.name)}:${column.name}`,
              )}
              sqlTableContext={sqlTableContext}
            />
          </ErrorBoundary>
        </div>
      )}
    </>
  );
};