@marimo-team/frontend 0.23.16-dev51 → 0.23.16-dev53

package/dist/index.html

@@ -66,7 +66,7 @@
     <marimo-server-token data-token="{{ server_token }}" hidden></marimo-server-token>
     <!-- /TODO -->
     <title>{{ title }}</title>
-    <script type="module" crossorigin src="./assets/index-CrEgp1mR.js"></script>
+    <script type="module" crossorigin src="./assets/index-Dz8dLbnI.js"></script>
     <link rel="modulepreload" crossorigin href="./assets/preload-helper-TXkS1QI3.js">
     <link rel="modulepreload" crossorigin href="./assets/objects-BlG0ZrO0.js">
     <link rel="modulepreload" crossorigin href="./assets/chunk-LvLJmgfZ.js">
@@ -134,7 +134,7 @@
     <link rel="modulepreload" crossorigin href="./assets/debounce-OiXznToA.js">
     <link rel="modulepreload" crossorigin href="./assets/database-zap-CKO8g4BU.js">
     <link rel="modulepreload" crossorigin href="./assets/main-BNL5rxQw.js">
-    <link rel="modulepreload" crossorigin href="./assets/cells-Jr-5Pc9f.js">
+    <link rel="modulepreload" crossorigin href="./assets/cells-CMc2NsXm.js">
     <link rel="modulepreload" crossorigin href="./assets/kbd-C5HnBH5U.js">
     <link rel="modulepreload" crossorigin href="./assets/useInstallPackage-WiYBwhUO.js">
     <link rel="modulepreload" crossorigin href="./assets/alert-dialog-Bb8Lz8ko.js">
@@ -147,40 +147,40 @@
     <link rel="modulepreload" crossorigin href="./assets/usePress-5hBv4sjD.js">
     <link rel="modulepreload" crossorigin href="./assets/input-JxFwu-3G.js">
     <link rel="modulepreload" crossorigin href="./assets/ImperativeModal-fY-ZfT0b.js">
-    <link rel="modulepreload" crossorigin href="./assets/cell-link-DqNEv3f9.js">
+    <link rel="modulepreload" crossorigin href="./assets/cell-link-DGv7Q4Mc.js">
     <link rel="modulepreload" crossorigin href="./assets/config-BJVx3eBW.js">
     <link rel="modulepreload" crossorigin href="./assets/alert-jlwhGxSb.js">
     <link rel="modulepreload" crossorigin href="./assets/chevron-right-BS_NcSch.js">
     <link rel="modulepreload" crossorigin href="./assets/dropdown-menu-dHmZR8bI.js">
     <link rel="modulepreload" crossorigin href="./assets/links-wcQA1Np1.js">
-    <link rel="modulepreload" crossorigin href="./assets/useRunCells-CF_V8X2K.js">
+    <link rel="modulepreload" crossorigin href="./assets/useRunCells-B-KIwrVZ.js">
     <link rel="modulepreload" crossorigin href="./assets/copy-Bxb1_Gtw.js">
     <link rel="modulepreload" crossorigin href="./assets/copy-3iHFdt22.js">
     <link rel="modulepreload" crossorigin href="./assets/copy-icon-neDQUo4Q.js">
-    <link rel="modulepreload" crossorigin href="./assets/RenderHTML-B9jx7Dsm.js">
-    <link rel="modulepreload" crossorigin href="./assets/datasource-AWkkAeiS.js">
-    <link rel="modulepreload" crossorigin href="./assets/state-bHyw5u3R.js">
+    <link rel="modulepreload" crossorigin href="./assets/RenderHTML-DRJxD5FQ.js">
+    <link rel="modulepreload" crossorigin href="./assets/datasource-Wt8yUynT.js">
+    <link rel="modulepreload" crossorigin href="./assets/state-BJ7IdtXW.js">
     <link rel="modulepreload" crossorigin href="./assets/hat-glasses-BttHlyvs.js">
     <link rel="modulepreload" crossorigin href="./assets/package-Bxz_8e44.js">
     <link rel="modulepreload" crossorigin href="./assets/sparkles-DUCpRFlS.js">
-    <link rel="modulepreload" crossorigin href="./assets/MarimoErrorOutput-Bh0y53Du.js">
+    <link rel="modulepreload" crossorigin href="./assets/MarimoErrorOutput-D9Dypu7Q.js">
     <link rel="modulepreload" crossorigin href="./assets/ErrorBoundary-DzTD8LVq.js">
     <link rel="modulepreload" crossorigin href="./assets/eye-off-BOZA7gbn.js">
     <link rel="modulepreload" crossorigin href="./assets/refresh-cw-CYq4mK5a.js">
-    <link rel="modulepreload" crossorigin href="./assets/tree-actions-DDveUIHK.js">
+    <link rel="modulepreload" crossorigin href="./assets/tree-actions-enwITSy7.js">
     <link rel="modulepreload" crossorigin href="./assets/spinner-D-V4psAa.js">
-    <link rel="modulepreload" crossorigin href="./assets/html-to-image-CfjhKLA4.js">
-    <link rel="modulepreload" crossorigin href="./assets/focus-C0HXXg3V.js">
+    <link rel="modulepreload" crossorigin href="./assets/html-to-image-Dm7huiQj.js">
+    <link rel="modulepreload" crossorigin href="./assets/focus-D64hL1tZ.js">
     <link rel="modulepreload" crossorigin href="./assets/useAsyncData-Bg5iAViP.js">
     <link rel="modulepreload" crossorigin href="./assets/LazyAnyLanguageCodeMirror-DPOEues4.js">
     <link rel="modulepreload" crossorigin href="./assets/micromark-factory-space-Dx_STMJD.js">
     <link rel="modulepreload" crossorigin href="./assets/chunk-5FQGJX7Z-BEbM01OT.js">
-    <link rel="modulepreload" crossorigin href="./assets/markdown-renderer-BgqeO4JR.js">
+    <link rel="modulepreload" crossorigin href="./assets/markdown-renderer-uWTrQId1.js">
     <link rel="modulepreload" crossorigin href="./assets/command-Dqxie4gq.js">
     <link rel="modulepreload" crossorigin href="./assets/field-BsxD35VE.js">
     <link rel="modulepreload" crossorigin href="./assets/popover-Bcz1Zikb.js">
     <link rel="modulepreload" crossorigin href="./assets/errors-PgHhDa-M.js">
-    <link rel="modulepreload" crossorigin href="./assets/download-CQ7iZFJL.js">
+    <link rel="modulepreload" crossorigin href="./assets/download-U_wgQ8mC.js">
     <link rel="modulepreload" crossorigin href="./assets/table-CH2plyy9.js">
     <link rel="modulepreload" crossorigin href="./assets/useIframeCapabilities-j6fR_dBA.js">
     <link rel="modulepreload" crossorigin href="./assets/error-banner-BSxEOIn2.js">
@@ -201,34 +201,34 @@
     <link rel="modulepreload" crossorigin href="./assets/plus-AgXtozBz.js">
     <link rel="modulepreload" crossorigin href="./assets/trash-2-72W0TZ3L.js">
     <link rel="modulepreload" crossorigin href="./assets/react-resizable-panels.browser.esm-Z-MD3n3J.js">
-    <link rel="modulepreload" crossorigin href="./assets/JsonOutput-BM3vve9F.js">
+    <link rel="modulepreload" crossorigin href="./assets/JsonOutput-E3o1Uk0e.js">
     <link rel="modulepreload" crossorigin href="./assets/chart-no-axes-column-iDRxid4h.js">
     <link rel="modulepreload" crossorigin href="./assets/square-function-DNNRTPQJ.js">
     <link rel="modulepreload" crossorigin href="./assets/spec-C7opZZRp.js">
-    <link rel="modulepreload" crossorigin href="./assets/column-preview-BUHlI5va.js">
+    <link rel="modulepreload" crossorigin href="./assets/column-preview-BeR1SI6Z.js">
     <link rel="modulepreload" crossorigin href="./assets/icons-CIPE8AIY.js">
-    <link rel="modulepreload" crossorigin href="./assets/radio-group-rhQpGwU-.js">
-    <link rel="modulepreload" crossorigin href="./assets/floating-outline-C6g75zrP.js">
+    <link rel="modulepreload" crossorigin href="./assets/radio-group-Da80KtoT.js">
+    <link rel="modulepreload" crossorigin href="./assets/floating-outline-BdgJT2B9.js">
     <link rel="modulepreload" crossorigin href="./assets/switch-OVajJBPR.js">
     <link rel="modulepreload" crossorigin href="./assets/objectWithoutPropertiesLoose-CboCOq4o.js">
     <link rel="modulepreload" crossorigin href="./assets/esm-B30N1GS0.js">
-    <link rel="modulepreload" crossorigin href="./assets/readonly-python-code-Q_1Y3VyZ.js">
+    <link rel="modulepreload" crossorigin href="./assets/readonly-python-code-Bmo6cMSq.js">
     <link rel="modulepreload" crossorigin href="./assets/file-headphone-DAu6VO6j.js">
     <link rel="modulepreload" crossorigin href="./assets/file-CJH9JNGH.js">
     <link rel="modulepreload" crossorigin href="./assets/image-5XI2VU-q.js">
-    <link rel="modulepreload" crossorigin href="./assets/file-icons-BAqZR08W.js">
+    <link rel="modulepreload" crossorigin href="./assets/file-icons-D5l3kSYq.js">
     <link rel="modulepreload" crossorigin href="./assets/events-90X9nql5.js">
     <link rel="modulepreload" crossorigin href="./assets/share-852X_cqy.js">
-    <link rel="modulepreload" crossorigin href="./assets/blob-BJREJiQp.js">
+    <link rel="modulepreload" crossorigin href="./assets/blob-BXcsY70H.js">
     <link rel="modulepreload" crossorigin href="./assets/memoize-Tp7rARFe.js">
     <link rel="modulepreload" crossorigin href="./assets/get-C-qh_et5.js">
     <link rel="modulepreload" crossorigin href="./assets/_baseSet-CsW0tABf.js">
-    <link rel="modulepreload" crossorigin href="./assets/state-DB_fxbhn.js">
+    <link rel="modulepreload" crossorigin href="./assets/state-TgAqts79.js">
     <link rel="modulepreload" crossorigin href="./assets/label-CqjrpwRC.js">
-    <link rel="modulepreload" crossorigin href="./assets/form-C051zAev.js">
+    <link rel="modulepreload" crossorigin href="./assets/form-b4jQBV3T.js">
     <link rel="modulepreload" crossorigin href="./assets/textarea-DZB2bzVL.js">
     <link rel="modulepreload" crossorigin href="./assets/refresh-ccw-sLaKP2vj.js">
-    <link rel="modulepreload" crossorigin href="./assets/form-DT44Rmhp.js">
+    <link rel="modulepreload" crossorigin href="./assets/form-CoqwGbkO.js">
     <link rel="modulepreload" crossorigin href="./assets/renderShortcut-Bl8_FVn8.js">
     <link rel="modulepreload" crossorigin href="./assets/useBoolean-CFj86iac.js">
     <link rel="modulepreload" crossorigin href="./assets/useDeepCompareMemoize-CSMoa-ga.js">
@@ -250,7 +250,7 @@
     <link rel="stylesheet" crossorigin href="./assets/cells-BVzo2MHf.css">
     <link rel="stylesheet" crossorigin href="./assets/markdown-renderer-DdDKmWlR.css">
     <link rel="stylesheet" crossorigin href="./assets/JsonOutput-BQtz7-np.css">
-    <link rel="stylesheet" crossorigin href="./assets/index-D6Dp_PFj.css">
+    <link rel="stylesheet" crossorigin href="./assets/index-8Nlyq3mV.css">
   </head>
   <body>
     <div id="root"></div>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@marimo-team/frontend",
-  "version": "0.23.16-dev51",
+  "version": "0.23.16-dev53",
   "main": "dist/main.js",
   "types": "dist/index.d.ts",
   "type": "module",

package/src/__mocks__/requests.ts

@@ -41,6 +41,7 @@ export const MockRequestClient = {
       previewSQLTableList: vi.fn().mockResolvedValue({ tables: [] }),
       previewSQLSchemaList: vi.fn().mockResolvedValue({ schemas: [] }),
       previewDataSourceConnection: vi.fn().mockResolvedValue({}),
+      discoverDataSources: vi.fn().mockResolvedValue({}),
       validateSQL: vi.fn().mockResolvedValue({}),
       openFile: vi.fn().mockResolvedValue({}),
       getUsageStats: vi.fn().mockResolvedValue({}),

package/src/components/editor/connections/__tests__/quick-add-data-sources.test.tsx

@@ -0,0 +1,113 @@
+/* Copyright 2026 Marimo. All rights reserved. */
+
+import { fireEvent, render, screen, waitFor } from "@testing-library/react";
+import { describe, expect, it, vi } from "vitest";
+import type { DetectedDataSource } from "@/core/datasets/data-source-discovery";
+import { QuickAddDataSources } from "../quick-add-data-sources";
+
+const sources: DetectedDataSource[] = [
+  {
+    id: "postgres-libpq-environment",
+    integration: "postgres",
+    category: "database",
+    displayName: "PostgreSQL",
+    confidence: "high",
+    origins: [{ type: "environment", label: "Kernel environment" }],
+    configuration: [
+      {
+        field: "Host",
+        value: { kind: "environment-variable", name: "PGHOST" },
+      },
+      {
+        field: "Username",
+        value: { kind: "environment-variable", name: "PGUSER" },
+      },
+      {
+        field: "Database",
+        value: { kind: "environment-variable", name: "PGDATABASE" },
+      },
+    ],
+    code: "engine = create_engine()",
+  },
+  {
+    id: "pyiceberg-prod",
+    integration: "pyiceberg",
+    category: "catalog",
+    displayName: "PyIceberg (prod)",
+    confidence: "high",
+    origins: [
+      {
+        type: "configuration",
+        label: "Resolved PyIceberg configuration",
+      },
+    ],
+    configuration: [
+      {
+        field: "Catalog",
+        value: { kind: "safe-literal", value: "prod" },
+      },
+      {
+        field: "Type",
+        value: { kind: "safe-literal", value: "REST" },
+      },
+    ],
+    code: 'catalog = load_catalog("prod")',
+  },
+];
+
+describe("QuickAddDataSources", () => {
+  it("does not render an empty section", () => {
+    const { container } = render(
+      <QuickAddDataSources sources={[]} onAdd={vi.fn()} />,
+    );
+
+    expect(container).toBeEmptyDOMElement();
+  });
+
+  it("renders detected sources as clickable tags", () => {
+    const onAdd = vi.fn();
+
+    render(<QuickAddDataSources sources={sources} onAdd={onAdd} />);
+    fireEvent.click(
+      screen.getByRole("button", {
+        name: "Add PostgreSQL connection",
+      }),
+    );
+
+    expect(screen.getByText("Quick add")).toBeInTheDocument();
+    expect(onAdd).toHaveBeenCalledWith(sources[0]);
+  });
+
+  it("shows environment references on hover", async () => {
+    render(<QuickAddDataSources sources={sources} onAdd={vi.fn()} />);
+    const tag = screen.getByRole("button", {
+      name: "Add PostgreSQL connection",
+    });
+
+    fireEvent.pointerMove(tag);
+    fireEvent.mouseOver(tag);
+
+    await waitFor(() => {
+      expect(screen.getAllByText('os.environ["PGHOST"]')).not.toHaveLength(0);
+    });
+    expect(screen.getAllByText('os.environ["PGUSER"]')).not.toHaveLength(0);
+    expect(screen.getAllByText('os.environ["PGDATABASE"]')).not.toHaveLength(0);
+  });
+
+  it("shows safe configuration metadata on hover", async () => {
+    render(<QuickAddDataSources sources={sources} onAdd={vi.fn()} />);
+    const tag = screen.getByRole("button", {
+      name: "Add PyIceberg (prod) connection",
+    });
+
+    fireEvent.pointerMove(tag);
+    fireEvent.mouseOver(tag);
+
+    await waitFor(() => {
+      expect(
+        screen.getAllByText("Detected from Resolved PyIceberg configuration"),
+      ).not.toHaveLength(0);
+    });
+    expect(screen.getAllByText("REST")).not.toHaveLength(0);
+  });
+});

package/src/components/editor/connections/add-connection-dialog.tsx

@@ -12,6 +12,7 @@ import {
 import { ExternalLink } from "@/components/ui/links";
 import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/components/ui/tabs";
 import { AddDatabaseForm } from "./database/add-database-form";
+import { AutoDiscoveredDataSources } from "./quick-add-data-sources";
 import { AddStorageForm } from "./storage/add-storage-form";
 
 type ConnectionTab = "databases" | "storage";
@@ -86,6 +87,7 @@ export const AddConnectionDialogContent: React.FC<{
           <span className="block">{codeSnippetHint}</span>
         </DialogDescription>
       </DialogHeader>
+      <AutoDiscoveredDataSources onSubmit={onClose} />
       <Tabs
         value={activeTab}
         onValueChange={(v) => setActiveTab(v as ConnectionTab)}

package/src/components/editor/connections/quick-add-data-sources.tsx

@@ -0,0 +1,106 @@
+/* Copyright 2026 Marimo. All rights reserved. */
+
+import { PlusIcon, SparklesIcon } from "lucide-react";
+import { Tooltip, TooltipProvider } from "@/components/ui/tooltip";
+import type { DetectedDataSource } from "@/core/datasets/data-source-discovery";
+import { useDataSourceDiscovery } from "@/hooks/useDataSourceDiscovery";
+import { useInsertCode } from "./components";
+
+export const QuickAddDataSources: React.FC<{
+  sources: DetectedDataSource[];
+  onAdd: (source: DetectedDataSource) => void;
+}> = ({ sources, onAdd }) => {
+  if (sources.length === 0) {
+    return null;
+  }
+
+  return (
+    <section
+      aria-labelledby="quick-add-data-sources-title"
+      className="rounded-md border bg-muted/30 px-3 py-2"
+    >
+      <div className="flex flex-wrap items-center gap-2">
+        <div className="mr-1 flex items-center gap-1.5">
+          <SparklesIcon className="h-3.5 w-3.5 text-muted-foreground" />
+          <h3 id="quick-add-data-sources-title" className="text-sm font-medium">
+            Quick add
+          </h3>
+        </div>
+        <TooltipProvider delayDuration={200}>
+          {sources.map((source) => (
+            <Tooltip
+              key={source.id}
+              side="bottom"
+              content={<DetectedDataSourceDetails source={source} />}
+            >
+              <button
+                type="button"
+                aria-label={`Add ${source.displayName} connection`}
+                className="inline-flex items-center gap-1 rounded-full border border-(--blue-8) bg-(--blue-2) px-2.5 py-1 text-xs font-semibold text-(--blue-11) transition-colors hover:bg-(--blue-3) focus:outline-hidden focus:ring-2 focus:ring-ring focus:ring-offset-2"
+                onClick={() => onAdd(source)}
+              >
+                <PlusIcon className="h-3 w-3" />
+                {source.displayName}
+              </button>
+            </Tooltip>
+          ))}
+        </TooltipProvider>
+      </div>
+    </section>
+  );
+};
+
+const DetectedDataSourceDetails: React.FC<{
+  source: DetectedDataSource;
+}> = ({ source }) => (
+  <div className="min-w-64 space-y-2 py-1">
+    <div>
+      <div className="font-medium">{source.displayName}</div>
+      <div className="text-xs text-muted-foreground">
+        Detected from{" "}
+        {source.origins.map((origin) => origin.label).join(" and ")}
+      </div>
+    </div>
+    <dl className="grid grid-cols-[auto_1fr] gap-x-3 gap-y-1 text-xs">
+      {source.configuration.map((item) => (
+        <div
+          className="contents"
+          key={
+            item.value.kind === "environment-variable"
+              ? item.value.name
+              : `${item.field}:${item.value.value}`
+          }
+        >
+          <dt className="text-muted-foreground">{item.field}</dt>
+          <dd>
+            <code>
+              {item.value.kind === "environment-variable"
+                ? `os.environ["${item.value.name}"]`
+                : item.value.value}
+            </code>
+          </dd>
+        </div>
+      ))}
+    </dl>
+    <div className="text-xs text-muted-foreground">
+      Click to add a configured cell.
+    </div>
+  </div>
+);
+
+export const AutoDiscoveredDataSources: React.FC<{
+  onSubmit: () => void;
+}> = ({ onSubmit }) => {
+  const insertCode = useInsertCode();
+  const { data } = useDataSourceDiscovery();
+
+  return (
+    <QuickAddDataSources
+      sources={data ?? []}
+      onAdd={(source) => {
+        insertCode(source.code);
+        onSubmit();
+      }}
+    />
+  );
+};

package/src/core/codemirror/language/__tests__/sql.test.ts

@@ -27,6 +27,7 @@ import type { HotkeyProvider } from "@/core/hotkeys/hotkeys";
 import { store } from "@/core/state/jotai";
 import type { PlaceholderType } from "../../config/types";
 import { TestSQLCompletionStore } from "../languages/sql/completion-store";
+import * as sqlMode from "../languages/sql/sql-mode";
 import {
   exportedForTesting,
   SQLLanguageAdapter,
@@ -971,13 +972,63 @@ describe("SQL analysis features", () => {
 });
 
 describe("CustomSqlParser", () => {
+  beforeEach(() => {
+    store.set(dataSourceConnectionsAtom, {
+      connectionsMap: new Map(),
+      latestEngineSelected: DUCKDB_ENGINE,
+    });
+  });
+
   afterEach(() => {
     vi.useRealTimers();
     vi.restoreAllMocks();
+    store.set(dataSourceConnectionsAtom, {
+      connectionsMap: new Map(),
+      latestEngineSelected: DUCKDB_ENGINE,
+    });
   });
 
+  const createNamedConnectionState = ({
+    doc,
+    engine,
+    dialect,
+  }: {
+    doc: string;
+    engine: ConnectionName;
+    dialect: string;
+  }) => {
+    store.set(dataSourceConnectionsAtom, {
+      connectionsMap: new Map([
+        [
+          engine,
+          {
+            name: engine,
+            dialect,
+            display_name: engine,
+            source: dialect,
+            databases: [],
+          },
+        ],
+      ]),
+      latestEngineSelected: engine,
+    });
+    return EditorState.create({
+      doc,
+      extensions: [
+        languageMetadataField.init(() => ({
+          dataframeName: "_df",
+          quotePrefix: "f",
+          commentLines: [],
+          showOutput: true,
+          engine,
+        })),
+      ],
+    });
+  };
+
   it("uses backend DuckDB validation", async () => {
     vi.useFakeTimers();
+    vi.spyOn(sqlMode, "getSQLMode").mockReturnValue("validate");
     const error = {
       message: "Backend syntax error",
       line: 1,
@@ -1009,13 +1060,146 @@ describe("CustomSqlParser", () => {
     await vi.runAllTimersAsync();
 
     await expect(result).resolves.toEqual([error]);
-    expect(request).toHaveBeenCalledWith(
-      expect.objectContaining({
-        engine: DUCKDB_ENGINE,
-        onlyParse: true,
-        query: "SELECT",
-      }),
-    );
+    // No connection is registered for the internal engine, so the dialect
+    // falls back to DEFAULT_PARSER_DIALECT ("DuckDB").
+    expect(request).toHaveBeenCalledWith({
+      dialect: "DuckDB",
+      engine: DUCKDB_ENGINE,
+      onlyParse: false,
+      query: "SELECT",
+    });
+  });
+
+  it("resolves superseded validation requests instead of leaving them pending", async () => {
+    vi.useFakeTimers();
+    vi.spyOn(sqlMode, "getSQLMode").mockReturnValue("validate");
+    const error = {
+      message: "Backend syntax error",
+      line: 1,
+      column: 1,
+      severity: "error" as const,
+    };
+    vi.spyOn(ValidateSQL, "request").mockResolvedValue({
+      error: null,
+      parse_result: { success: false, errors: [error] },
+      request_id: "request-id",
+      validate_result: null,
+    });
+    const state = EditorState.create({
+      doc: "SELECT",
+      extensions: [
+        languageMetadataField.init(() => ({
+          dataframeName: "_df",
+          quotePrefix: "f",
+          commentLines: [],
+          showOutput: true,
+          engine: DUCKDB_ENGINE,
+        })),
+      ],
+    });
+    const parser = new exportedForTesting.CustomSqlParser();
+    parser.setFocusState(true);
+
+    // Simulate a rapid edit: a second validation call arrives before the
+    // first call's internal debounce timer has fired. The first call should
+    // resolve (with no errors) rather than hang forever.
+    const first = parser.validateSql("SELECT 1", { state });
+    await vi.advanceTimersByTimeAsync(100);
+    const second = parser.validateSql("SELECT 2", { state });
+    await vi.runAllTimersAsync();
+
+    await expect(first).resolves.toEqual([]);
+    await expect(second).resolves.toEqual([error]);
+  });
+
+  it("uses backend validation for a named DuckDB connection", async () => {
+    vi.useFakeTimers();
+    vi.spyOn(sqlMode, "getSQLMode").mockReturnValue("validate");
+    const query =
+      'INSERT OR IGNORE INTO "rebalance-dates" (Timestamp) VALUES (CURRENT_TIMESTAMP);';
+    const error = {
+      message: "Named DuckDB backend result",
+      line: 1,
+      column: 1,
+      severity: "error" as const,
+    };
+    const request = vi.spyOn(ValidateSQL, "request").mockResolvedValue({
+      error: null,
+      parse_result: { success: false, errors: [error] },
+      request_id: "request-id",
+      validate_result: null,
+    });
+    const state = createNamedConnectionState({
+      doc: query,
+      engine: "con" as ConnectionName,
+      dialect: "duckdb",
+    });
+    const parser = new exportedForTesting.CustomSqlParser();
+    parser.setFocusState(true);
+
+    const result = parser.validateSql(query, { state });
+    await vi.runAllTimersAsync();
+
+    await expect(result).resolves.toEqual([error]);
+    expect(request).toHaveBeenCalledWith({
+      dialect: "DuckDB",
+      engine: "con",
+      onlyParse: true,
+      query,
+    });
+  });
+
+  it("skips client-side parsing for named DuckDB SQL", async () => {
+    const query = "CHECKPOINT;";
+    const state = createNamedConnectionState({
+      doc: query,
+      engine: "con" as ConnectionName,
+      dialect: "duckdb",
+    });
+    const parser = new exportedForTesting.CustomSqlParser();
+
+    await expect(parser.parse(query, { state })).resolves.toEqual({
+      success: true,
+      errors: [],
+    });
+  });
+
+  it("preserves client-side parsing for non-DuckDB connections", async () => {
+    const query = "SELECT TOP 1 * FROM users";
+    const state = createNamedConnectionState({
+      doc: query,
+      engine: "postgres_con" as ConnectionName,
+      dialect: "postgres",
+    });
+    const parser = new exportedForTesting.CustomSqlParser();
+
+    await expect(parser.parse(query, { state })).resolves.toMatchObject({
+      success: false,
+    });
+  });
+
+  it("preserves client-side parsing for an unregistered connection", async () => {
+    // No entry is registered in the data source connections store for this
+    // engine, so its dialect cannot be resolved (unlike a known non-DuckDB
+    // dialect, which resolves to a non-null, non-DuckDB value).
+    const query = "SELECT TOP 1 * FROM users";
+    const state = EditorState.create({
+      doc: query,
+      extensions: [
+        languageMetadataField.init(() => ({
+          dataframeName: "_df",
+          quotePrefix: "f",
+          commentLines: [],
+          showOutput: true,
+          engine: "unregistered_con" as ConnectionName,
+        })),
+      ],
+    });
+    const parser = new exportedForTesting.CustomSqlParser();
+
+    await expect(parser.parse(query, { state })).resolves.toMatchObject({
+      success: false,
+    });
   });
 });