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.

fix: tolerate unknown frontend data types (#10509)

Kiran Gadhave988e656b8534
diff --git a/frontend/src/components/data-table/charts/__tests__/schemas.test.ts b/frontend/src/components/data-table/charts/__tests__/schemas.test.ts
new file mode 100644
index 0000000000..c2ade19f7e
--- /dev/null
+++ b/frontend/src/components/data-table/charts/__tests__/schemas.test.ts
@@ -0,0 +1,35 @@
+/* Copyright 2026 Marimo. All rights reserved. */
+
+import { describe, expect, it } from "vitest";
+import { ChartSchema } from "../schemas";
+
+describe("ChartSchema", () => {
+ it("keeps a known axis column type", () => {
+ const result = ChartSchema.parse({
+ general: { xColumn: { field: "count", type: "integer" } },
+ });
+
+ expect(result.general?.xColumn?.type).toBe("integer");
+ });
+
+ it("normalizes an unrecognized axis column type", () => {
+ const result = ChartSchema.parse({
+ general: { xColumn: { field: "geom", type: "geometry" } },
+ });
+
+ expect(result.general?.xColumn?.type).toBe("unknown");
+ });
+
+ it("normalizes an unrecognized tooltip field type", () => {
+ const result = ChartSchema.parse({
+ tooltips: {
+ auto: false,
+ fields: [{ field: "geom", type: "geometry" }],
+ },
+ });
+
+ expect(result.tooltips?.fields).toEqual([
+ { field: "geom", type: "unknown" },
+ ]);
+ });
+});
diff --git a/frontend/src/components/data-table/charts/schemas.ts b/frontend/src/components/data-table/charts/schemas.ts
index cfa836df73..5a7f2021dd 100644
--- a/frontend/src/components/data-table/charts/schemas.ts
+++ b/frontend/src/components/data-table/charts/schemas.ts
@@ -28,7 +28,10 @@ export const BinSchema = z.object({
const BaseColumnSchema = z.object({
field: z.string().optional(),
- type: z.enum([...DATA_TYPES, EMPTY_VALUE]).optional(),
+ type: z
+ .enum([...DATA_TYPES, EMPTY_VALUE])
+ .catch("unknown")
+ .optional(),
selectedDataType: z.enum([...SELECTABLE_DATA_TYPES, EMPTY_VALUE]).optional(),
sort: z.enum(SORT_TYPES).default("ascending").optional(),
timeUnit: z.enum(TIME_UNITS).optional(),
@@ -102,7 +105,7 @@ export const ChartSchema = z.object({
fields: z.array(
z.object({
field: z.string(),
- type: z.enum(DATA_TYPES),
+ type: z.enum(DATA_TYPES).catch("unknown"),
}),
),
})
diff --git a/frontend/src/components/datasets/__tests__/icons.test.ts b/frontend/src/components/datasets/__tests__/icons.test.ts
new file mode 100644
index 0000000000..23b89f0de3
--- /dev/null
+++ b/frontend/src/components/datasets/__tests__/icons.test.ts
@@ -0,0 +1,21 @@
+/* Copyright 2026 Marimo. All rights reserved. */
+
+import { describe, expect, it } from "vitest";
+import type { DataType } from "@/core/kernel/messages";
+import { DATA_TYPE_ICON, resolveDataType } from "../icons";
+
+describe("resolveDataType", () => {
+ it("passes through every mapped data type", () => {
+ for (const dataType of Object.keys(DATA_TYPE_ICON)) {
+ expect(resolveDataType(dataType as DataType)).toBe(dataType);
+ }
+ });
+
+ it("resolves unmapped data types to unknown", () => {
+ expect(resolveDataType("geometry" as DataType)).toBe("unknown");
+ });
+
+ it("resolves data types shadowing Object.prototype keys to unknown", () => {
+ expect(resolveDataType("toString" as DataType)).toBe("unknown");
+ });
+});
diff --git a/frontend/src/components/datasets/icons.tsx b/frontend/src/components/datasets/icons.tsx
index 835eabb2c9..0d985e315d 100644
--- a/frontend/src/components/datasets/icons.tsx
+++ b/frontend/src/components/datasets/icons.tsx
@@ -30,6 +30,16 @@ export const DATA_TYPE_ICON: Record<DataType | SelectableDataType, LucideIcon> =
unknown: CurlyBracesIcon,
};
+/**
+ * A newer backend can send a data type this frontend does not know. Resolve
+ * those to `unknown` before indexing icon or color maps.
+ */
+export function resolveDataType(
+ dataType: DataType | SelectableDataType,
+): DataType | SelectableDataType {
+ return Object.hasOwn(DATA_TYPE_ICON, dataType) ? dataType : "unknown";
+}
+
export function getDataTypeColor(
dataType: DataType | SelectableDataType,
): string {
diff --git a/frontend/src/components/datasources/__tests__/components.test.tsx b/frontend/src/components/datasources/__tests__/components.test.tsx
new file mode 100644
index 0000000000..3d000665f7
--- /dev/null
+++ b/frontend/src/components/datasources/__tests__/components.test.tsx
@@ -0,0 +1,29 @@
+/* Copyright 2026 Marimo. All rights reserved. */
+
+import { render } from "@testing-library/react";
+import { describe, expect, it, vi } from "vitest";
+import type { DataType } from "@/core/kernel/messages";
+import { Logger } from "@/utils/Logger";
+import { ColumnName } from "../components";
+
+describe("ColumnName", () => {
+ it("renders the unknown icon for unrecognized data types", () => {
+ const warn = vi.spyOn(Logger, "warn").mockImplementation(() => {});
+
+ try {
+ const unrecognized = render(
+ <ColumnName columnName="geom" dataType={"geometry" as DataType} />,
+ );
+ const unknown = render(
+ <ColumnName columnName="geom" dataType="unknown" />,
+ );
+
+ expect(unrecognized.container.innerHTML).toEqual(
+ unknown.container.innerHTML,
+ );
+ expect(warn).not.toHaveBeenCalled();
+ } finally {
+ warn.mockRestore();
+ }
+ });
+});
diff --git a/frontend/src/components/datasources/components.tsx b/frontend/src/components/datasources/components.tsx
index abc538a330..98fac43ef1 100644
--- a/frontend/src/components/datasources/components.tsx
+++ b/frontend/src/components/datasources/components.tsx
@@ -5,7 +5,11 @@ import type { CSSProperties } from "react";
import { TreeChevron } from "@/components/editor/file-tree/tree-actions";
import type { DataType } from "@/core/kernel/messages";
import { cn } from "@/utils/cn";
-import { DATA_TYPE_ICON, getDataTypeColor } from "../datasets/icons";
+import {
+ DATA_TYPE_ICON,
+ getDataTypeColor,
+ resolveDataType,
+} from "../datasets/icons";
export const RotatingChevron: React.FC<{ isExpanded: boolean }> = ({
isExpanded,
@@ -101,8 +105,9 @@ export const ColumnName = ({
columnName: React.ReactNode;
dataType: DataType;
}) => {
- const Icon = DATA_TYPE_ICON[dataType];
- const color = getDataTypeColor(dataType);
+ const resolvedDataType = resolveDataType(dataType);
+ const Icon = DATA_TYPE_ICON[resolvedDataType];
+ const color = getDataTypeColor(resolvedDataType);
return (
<div className="flex flex-row items-center gap-1.5">
diff --git a/frontend/src/core/codemirror/language/languages/sql/__tests__/renderers.test.tsx b/frontend/src/core/codemirror/language/languages/sql/__tests__/renderers.test.tsx
new file mode 100644
index 0000000000..ba51baa5c7
--- /dev/null
+++ b/frontend/src/core/codemirror/language/languages/sql/__tests__/renderers.test.tsx
@@ -0,0 +1,44 @@
+/* Copyright 2026 Marimo. All rights reserved. */
+
+import { render } from "@testing-library/react";
+import { describe, expect, it } from "vitest";
+import type {
+ DataTable,
+ DataTableColumn,
+ DataType,
+} from "@/core/kernel/messages";
+import { renderColumnInfo, renderTableInfo } from "../renderers";
+
+const geometryColumn = {
+ name: "geom",
+ type: "geometry" as DataType,
+ external_type: "geometry",
+ sample_values: [],
+} as DataTableColumn;
+
+describe("SQL renderers", () => {
+ it("renders table information with an unrecognized column type", () => {
+ const table: DataTable = {
+ name: "shapes",
+ type: "table",
+ source: "local",
+ source_type: "local",
+ num_rows: null,
+ num_columns: 1,
+ variable_name: null,
+ columns: [geometryColumn],
+ primary_keys: [],
+ indexes: [],
+ };
+
+ const result = render(renderTableInfo(table));
+
+ expect(result.container.querySelector("svg")).not.toBeNull();
+ });
+
+ it("renders column information with an unrecognized column type", () => {
+ const result = render(renderColumnInfo(geometryColumn));
+
+ expect(result.container.querySelector("svg")).not.toBeNull();
+ });
+});
diff --git a/frontend/src/core/codemirror/language/languages/sql/renderers.tsx b/frontend/src/core/codemirror/language/languages/sql/renderers.tsx
index 77c299ccd1..beeed4667d 100644
--- a/frontend/src/core/codemirror/language/languages/sql/renderers.tsx
+++ b/frontend/src/core/codemirror/language/languages/sql/renderers.tsx
@@ -13,7 +13,7 @@ import {
TableIcon,
ViewIcon,
} from "@/components/databases/namespace-icons";
-import { DATA_TYPE_ICON } from "@/components/datasets/icons";
+import { DATA_TYPE_ICON, resolveDataType } from "@/components/datasets/icons";
import { Badge } from "@/components/ui/badge";
import {
type ConnectionName,
@@ -149,7 +149,7 @@ export const renderTableInfo = (table: DataTable): React.ReactNode => {
);
const columnItems = table.columns.map((column) => {
- const TypeIcon = DATA_TYPE_ICON[column.type];
+ const TypeIcon = DATA_TYPE_ICON[resolveDataType(column.type)];
return (
<div
key={column.name}
@@ -288,7 +288,7 @@ export const renderTableInfo = (table: DataTable): React.ReactNode => {
};
export const renderColumnInfo = (column: DataTableColumn): React.ReactNode => {
- const TypeIcon = DATA_TYPE_ICON[column.type];
+ const TypeIcon = DATA_TYPE_ICON[resolveDataType(column.type)];
const typeBadge = (
<Badge
diff --git a/frontend/src/plugins/impl/DataEditorPlugin.tsx b/frontend/src/plugins/impl/DataEditorPlugin.tsx
index 6eb8aef0df..a10e9d3439 100644
--- a/frontend/src/plugins/impl/DataEditorPlugin.tsx
+++ b/frontend/src/plugins/impl/DataEditorPlugin.tsx
@@ -8,10 +8,10 @@ import { LoadingTable } from "@/components/data-table/loading-table";
import { type FieldTypes, toFieldTypes } from "@/components/data-table/types";
import { Alert, AlertTitle } from "@/components/ui/alert";
import { DelayMount } from "@/components/utils/delay-mount";
-import { DATA_TYPES } from "@/core/kernel/messages";
import { useAsyncData } from "@/hooks/useAsyncData";
import { createPlugin } from "../core/builder";
import type { Setter } from "../types";
+import { columnToFieldTypesSchema } from "./data-frames/schema";
import {
BulkEdit,
type DataEditorProps,
@@ -44,14 +44,7 @@ export const DataEditorPlugin = createPlugin<Edits>("marimo-data-editor", {
}),
label: z.string().nullable(),
data: z.union([z.string(), z.array(z.object({}).passthrough())]),
- fieldTypes: z
- .array(
- z.tuple([
- z.coerce.string(),
- z.tuple([z.enum(DATA_TYPES), z.string()]),
- ]),
- )
- .nullish(),
+ fieldTypes: columnToFieldTypesSchema.nullish(),
editableColumns: z.union([z.array(z.string()), z.literal("all")]),
columnSizingMode: z.enum(["auto", "fit"]).default("auto"), // TODO: Remove this
}),
diff --git a/frontend/src/plugins/impl/__tests__/DataEditorPlugin.test.ts b/frontend/src/plugins/impl/__tests__/DataEditorPlugin.test.ts
new file mode 100644
index 0000000000..2d7642c23b
--- /dev/null
+++ b/frontend/src/plugins/impl/__tests__/DataEditorPlugin.test.ts
@@ -0,0 +1,18 @@
+/* Copyright 2026 Marimo. All rights reserved. */
+
+import { describe, expect, it } from "vitest";
+import { DataEditorPlugin } from "../DataEditorPlugin";
+
+describe("DataEditorPlugin", () => {
+ it("normalizes an unrecognized field type", () => {
+ const result = DataEditorPlugin.validator.parse({
+ initialValue: { edits: [] },
+ label: null,
+ data: [],
+ fieldTypes: [["geom", ["geometry", "geometry"]]],
+ editableColumns: "all",
+ });
+
+ expect(result.fieldTypes).toEqual([["geom", ["unknown", "geometry"]]]);
+ });
+});
diff --git a/frontend/src/plugins/impl/data-frames/__tests__/schema.test.ts b/frontend/src/plugins/impl/data-frames/__tests__/schema.test.ts
new file mode 100644
index 0000000000..ae16968253
--- /dev/null
+++ b/frontend/src/plugins/impl/data-frames/__tests__/schema.test.ts
@@ -0,0 +1,30 @@
+/* Copyright 2026 Marimo. All rights reserved. */
+
+import { describe, expect, it } from "vitest";
+import { columnToFieldTypesSchema } from "../schema";
+
+describe("columnToFieldTypesSchema", () => {
+ it("keeps known field types", () => {
+ const result = columnToFieldTypesSchema.parse([
+ ["count", ["integer", "int64"]],
+ ["label", ["string", "object"]],
+ ]);
+
+ expect(result).toEqual([
+ ["count", ["integer", "int64"]],
+ ["label", ["string", "object"]],
+ ]);
+ });
+
+ it("normalizes an unrecognized field type without discarding other fields", () => {
+ const result = columnToFieldTypesSchema.parse([
+ ["geom", ["geometry", "geometry"]],
+ ["label", ["string", "object"]],
+ ]);
+
+ expect(result).toEqual([
+ ["geom", ["unknown", "geometry"]],
+ ["label", ["string", "object"]],
+ ]);
+ });
+});
diff --git a/frontend/src/plugins/impl/data-frames/schema.ts b/frontend/src/plugins/impl/data-frames/schema.ts
index 7717837133..c571996210 100644
--- a/frontend/src/plugins/impl/data-frames/schema.ts
+++ b/frontend/src/plugins/impl/data-frames/schema.ts
@@ -15,7 +15,10 @@ import {
} from "./utils/operators";
export const columnToFieldTypesSchema = z.array(
- z.tuple([z.coerce.string(), z.tuple([z.enum(DATA_TYPES), z.string()])]),
+ z.tuple([
+ z.coerce.string(),
+ z.tuple([z.enum(DATA_TYPES).catch("unknown"), z.string()]),
+ ]),
);
export const column_id = z