@sqlrooms/cells 0.29.0-rc.1

package/dist/resultRelationPolicy.js

@@ -0,0 +1,74 @@
+function toRelationSqlName(relationName) {
+    return relationName.toString();
+}
+/**
+ * Chooses whether a SQL cell result should be stored as a logical view or a
+ * materialized table.
+ *
+ * The policy is sticky: once a relation type has been selected for a cell,
+ * later executions preserve that choice. On first execution, downstream usage
+ * is used as a proxy for reuse.
+ */
+export function chooseAdaptiveRelationType(args) {
+    const { previousRelationType, hasDownstream } = args;
+    if (previousRelationType)
+        return previousRelationType;
+    return hasDownstream ? 'table' : 'view';
+}
+/**
+ * Creates or replaces the relation that backs a SQL cell result.
+ *
+ * - `table`: materializes data for stable repeated reads.
+ * - `view`: stores query definition for lightweight freshness.
+ */
+export async function createOrReplaceResultRelation(args) {
+    const { connector, relationName, relationType, sql, signal } = args;
+    const relationSqlName = toRelationSqlName(relationName);
+    if (relationType === 'table') {
+        await connector.query(`CREATE OR REPLACE TABLE ${relationSqlName} AS ${sql}`, {
+            signal,
+        });
+        return;
+    }
+    await connector.query(`CREATE OR REPLACE VIEW ${relationSqlName} AS ${sql}`, {
+        signal,
+    });
+}
+/**
+ * Drops both view and table variants for a relation name.
+ *
+ * This is intentionally defensive because different runs may have used
+ * different relation modes.
+ */
+export async function dropResultRelation(args) {
+    const { connector, relationName } = args;
+    if (!relationName)
+        return;
+    const relationSqlName = toRelationSqlName(relationName);
+    await connector.query(`DROP VIEW IF EXISTS ${relationSqlName}`);
+    await connector.query(`DROP TABLE IF EXISTS ${relationSqlName}`);
+}
+/**
+ * Renames a saved SQL cell result relation while preserving its mode.
+ *
+ * - `table`: copies current relation data into the new name.
+ * - `view`: recreates the view definition under the new name.
+ *
+ * Any existing destination relation is removed first, and the old source name
+ * is cleaned up after the new relation is created.
+ */
+export async function renameResultRelation(args) {
+    const { connector, oldRelationName, newRelationName, relationType, viewSql } = args;
+    const oldRelationSqlName = toRelationSqlName(oldRelationName);
+    const newRelationSqlName = toRelationSqlName(newRelationName);
+    // Clear destination first in case a stale object exists.
+    await dropResultRelation({ connector, relationName: newRelationSqlName });
+    if (relationType === 'table') {
+        await connector.query(`CREATE TABLE ${newRelationSqlName} AS SELECT * FROM ${oldRelationSqlName}`);
+    }
+    else {
+        await connector.query(`CREATE VIEW ${newRelationSqlName} AS ${viewSql}`);
+    }
+    await dropResultRelation({ connector, relationName: oldRelationSqlName });
+}
+//# sourceMappingURL=resultRelationPolicy.js.map

package/dist/resultRelationPolicy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resultRelationPolicy.js","sourceRoot":"","sources":["../src/resultRelationPolicy.ts"],"names":[],"mappings":"AAyBA,SAAS,iBAAiB,CAAC,YAAgC;IACzD,OAAO,YAAY,CAAC,QAAQ,EAAE,CAAC;AACjC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,0BAA0B,CAAC,IAG1C;IACC,MAAM,EAAC,oBAAoB,EAAE,aAAa,EAAC,GAAG,IAAI,CAAC;IACnD,IAAI,oBAAoB;QAAE,OAAO,oBAAoB,CAAC;IACtD,OAAO,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;AAC1C,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,6BAA6B,CAAC,IAMnD;IACC,MAAM,EAAC,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,EAAC,GAAG,IAAI,CAAC;IAClE,MAAM,eAAe,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAAC;IACxD,IAAI,YAAY,KAAK,OAAO,EAAE,CAAC;QAC7B,MAAM,SAAS,CAAC,KAAK,CACnB,2BAA2B,eAAe,OAAO,GAAG,EAAE,EACtD;YACE,MAAM;SACP,CACF,CAAC;QACF,OAAO;IACT,CAAC;IACD,MAAM,SAAS,CAAC,KAAK,CAAC,0BAA0B,eAAe,OAAO,GAAG,EAAE,EAAE;QAC3E,MAAM;KACP,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAGxC;IACC,MAAM,EAAC,SAAS,EAAE,YAAY,EAAC,GAAG,IAAI,CAAC;IACvC,IAAI,CAAC,YAAY;QAAE,OAAO;IAC1B,MAAM,eAAe,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAAC;IACxD,MAAM,SAAS,CAAC,KAAK,CAAC,uBAAuB,eAAe,EAAE,CAAC,CAAC;IAChE,MAAM,SAAS,CAAC,KAAK,CAAC,wBAAwB,eAAe,EAAE,CAAC,CAAC;AACnE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAM1C;IACC,MAAM,EAAC,SAAS,EAAE,eAAe,EAAE,eAAe,EAAE,YAAY,EAAE,OAAO,EAAC,GACxE,IAAI,CAAC;IACP,MAAM,kBAAkB,GAAG,iBAAiB,CAAC,eAAe,CAAC,CAAC;IAC9D,MAAM,kBAAkB,GAAG,iBAAiB,CAAC,eAAe,CAAC,CAAC;IAE9D,yDAAyD;IACzD,MAAM,kBAAkB,CAAC,EAAC,SAAS,EAAE,YAAY,EAAE,kBAAkB,EAAC,CAAC,CAAC;IAExE,IAAI,YAAY,KAAK,OAAO,EAAE,CAAC;QAC7B,MAAM,SAAS,CAAC,KAAK,CACnB,gBAAgB,kBAAkB,qBAAqB,kBAAkB,EAAE,CAC5E,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,MAAM,SAAS,CAAC,KAAK,CAAC,eAAe,kBAAkB,OAAO,OAAO,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,MAAM,kBAAkB,CAAC,EAAC,SAAS,EAAE,YAAY,EAAE,kBAAkB,EAAC,CAAC,CAAC;AAC1E,CAAC","sourcesContent":["import type {QualifiedTableName} from '@sqlrooms/duckdb';\n\n/**\n * Centralized policy for persisting SQL cell query results.\n *\n * This module implements an adaptive strategy:\n * - first run chooses `table` when downstream dependencies exist, otherwise\n *   `view`;\n * - subsequent runs preserve the previously chosen relation type.\n *\n * The policy is shared by execution, rename, and cleanup paths so behavior\n * stays consistent across cross-cutting lifecycle events. Cleanup intentionally\n * drops both relation variants (`VIEW` and `TABLE`) because historical runs or\n * migrations may have created either form for the same logical result name.\n */\nexport type ResultRelationType = 'view' | 'table';\nexport type ResultRelationName = string | QualifiedTableName;\n\ntype SqlConnectorLike = {\n  query: (\n    sql: string,\n    options?: {signal?: AbortSignal},\n  ) => PromiseLike<unknown>;\n};\n\nfunction toRelationSqlName(relationName: ResultRelationName): string {\n  return relationName.toString();\n}\n\n/**\n * Chooses whether a SQL cell result should be stored as a logical view or a\n * materialized table.\n *\n * The policy is sticky: once a relation type has been selected for a cell,\n * later executions preserve that choice. On first execution, downstream usage\n * is used as a proxy for reuse.\n */\nexport function chooseAdaptiveRelationType(args: {\n  previousRelationType?: ResultRelationType;\n  hasDownstream: boolean;\n}): ResultRelationType {\n  const {previousRelationType, hasDownstream} = args;\n  if (previousRelationType) return previousRelationType;\n  return hasDownstream ? 'table' : 'view';\n}\n\n/**\n * Creates or replaces the relation that backs a SQL cell result.\n *\n * - `table`: materializes data for stable repeated reads.\n * - `view`: stores query definition for lightweight freshness.\n */\nexport async function createOrReplaceResultRelation(args: {\n  connector: SqlConnectorLike;\n  relationName: ResultRelationName;\n  relationType: ResultRelationType;\n  sql: string;\n  signal?: AbortSignal;\n}) {\n  const {connector, relationName, relationType, sql, signal} = args;\n  const relationSqlName = toRelationSqlName(relationName);\n  if (relationType === 'table') {\n    await connector.query(\n      `CREATE OR REPLACE TABLE ${relationSqlName} AS ${sql}`,\n      {\n        signal,\n      },\n    );\n    return;\n  }\n  await connector.query(`CREATE OR REPLACE VIEW ${relationSqlName} AS ${sql}`, {\n    signal,\n  });\n}\n\n/**\n * Drops both view and table variants for a relation name.\n *\n * This is intentionally defensive because different runs may have used\n * different relation modes.\n */\nexport async function dropResultRelation(args: {\n  connector: SqlConnectorLike;\n  relationName?: ResultRelationName;\n}) {\n  const {connector, relationName} = args;\n  if (!relationName) return;\n  const relationSqlName = toRelationSqlName(relationName);\n  await connector.query(`DROP VIEW IF EXISTS ${relationSqlName}`);\n  await connector.query(`DROP TABLE IF EXISTS ${relationSqlName}`);\n}\n\n/**\n * Renames a saved SQL cell result relation while preserving its mode.\n *\n * - `table`: copies current relation data into the new name.\n * - `view`: recreates the view definition under the new name.\n *\n * Any existing destination relation is removed first, and the old source name\n * is cleaned up after the new relation is created.\n */\nexport async function renameResultRelation(args: {\n  connector: SqlConnectorLike;\n  oldRelationName: ResultRelationName;\n  newRelationName: ResultRelationName;\n  relationType: ResultRelationType;\n  viewSql: string;\n}) {\n  const {connector, oldRelationName, newRelationName, relationType, viewSql} =\n    args;\n  const oldRelationSqlName = toRelationSqlName(oldRelationName);\n  const newRelationSqlName = toRelationSqlName(newRelationName);\n\n  // Clear destination first in case a stale object exists.\n  await dropResultRelation({connector, relationName: newRelationSqlName});\n\n  if (relationType === 'table') {\n    await connector.query(\n      `CREATE TABLE ${newRelationSqlName} AS SELECT * FROM ${oldRelationSqlName}`,\n    );\n  } else {\n    await connector.query(`CREATE VIEW ${newRelationSqlName} AS ${viewSql}`);\n  }\n\n  await dropResultRelation({connector, relationName: oldRelationSqlName});\n}\n"]}

package/dist/sqlHelpers.d.ts

@@ -0,0 +1,41 @@
+import type { Cell, Edge, SqlDependencyOptions, SqlRenderInput, SqlRunCallbacks, SqlRunResult } from './types';
+export declare function deriveEdgesFromSql(cellId: string, sql: string, allCells: Record<string, Cell>): Edge[];
+export declare function renderSqlWithInputs(rawSql: string, inputs: SqlRenderInput[]): string;
+export declare function findSqlDependencies<TCell extends {
+    id: string;
+    type: string;
+}>(opts: {
+    targetCell: TCell;
+    cells: Record<string, TCell>;
+    getSqlText: (cell: TCell) => string | undefined;
+    getInputVarName: (cell: TCell) => string | undefined;
+    getSqlResultName: (cellId: string) => string | undefined;
+    options?: SqlDependencyOptions;
+}): string[];
+export declare function runSqlWithCallbacks(run: () => Promise<SqlRunResult>, callbacks?: SqlRunCallbacks): Promise<void>;
+/**
+ * Find SQL cell dependencies using AST-based parsing.
+ * This provides more accurate detection than text-based matching.
+ */
+export declare function findSqlDependenciesFromAst(opts: {
+    sql: string;
+    cells: Record<string, Cell>;
+    sqlSelectToJson: (sql: string) => Promise<{
+        error: boolean;
+        statements?: unknown[];
+    }>;
+}): Promise<string[]>;
+/**
+ * Rewrites unqualified references to known sheet-local result names as
+ * schema-qualified references. This keeps SQL ergonomic without mutable
+ * connector-level current schema state.
+ */
+export declare function qualifySheetLocalResultNames(opts: {
+    sql: string;
+    sheetSchema: string;
+    sheetDatabase?: string;
+    sheetCellIds: string[];
+    cells: Record<string, Cell>;
+    getSqlResultName: (cellId: string) => string | undefined;
+}): string;
+//# sourceMappingURL=sqlHelpers.d.ts.map

package/dist/sqlHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlHelpers.d.ts","sourceRoot":"","sources":["../src/sqlHelpers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,IAAI,EACJ,IAAI,EAEJ,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,YAAY,EACb,MAAM,SAAS,CAAC;AAIjB,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GAC7B,IAAI,EAAE,CA2BR;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,cAAc,EAAE,GACvB,MAAM,CAcR;AAED,wBAAgB,mBAAmB,CACjC,KAAK,SAAS;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAC,EACxC,IAAI,EAAE;IACN,UAAU,EAAE,KAAK,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC7B,UAAU,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,MAAM,GAAG,SAAS,CAAC;IAChD,eAAe,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,MAAM,GAAG,SAAS,CAAC;IACrD,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACzD,OAAO,CAAC,EAAE,oBAAoB,CAAC;CAChC,GAAG,MAAM,EAAE,CAyCX;AAeD,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,EAChC,SAAS,GAAE,eAAoB,iBAYhC;AAsCD;;;GAGG;AACH,wBAAsB,0BAA0B,CAAC,IAAI,EAAE;IACrD,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC5B,eAAe,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;QACxC,KAAK,EAAE,OAAO,CAAC;QACf,UAAU,CAAC,EAAE,OAAO,EAAE,CAAC;KACxB,CAAC,CAAC;CACJ,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAkCpB;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC5B,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CAC1D,GAAG,MAAM,CAqCT"}

package/dist/sqlHelpers.js

@@ -0,0 +1,190 @@
+import { convertToValidColumnOrTableName } from '@sqlrooms/utils';
+import { isInputCell, isSqlCell } from './types';
+import { getEffectiveResultName } from './utils';
+export function deriveEdgesFromSql(cellId, sql, allCells) {
+    const targetCell = allCells[cellId];
+    if (!targetCell)
+        return [];
+    const deps = findSqlDependencies({
+        targetCell,
+        cells: allCells,
+        getSqlText: () => sql,
+        getInputVarName: (cell) => isInputCell(cell) ? cell.data.input.varName : undefined,
+        getSqlResultName: (cid) => {
+            const cell = allCells[cid];
+            if (cell && isSqlCell(cell)) {
+                return getEffectiveResultName(cell.data, convertToValidColumnOrTableName);
+            }
+            return undefined;
+        },
+    });
+    return deps.map((sourceId) => ({
+        id: `${sourceId}-${cellId}`,
+        source: sourceId,
+        target: cellId,
+    }));
+}
+export function renderSqlWithInputs(rawSql, inputs) {
+    const varMap = {};
+    for (const { varName, value } of inputs) {
+        varMap[varName] = value;
+    }
+    return (rawSql || '').replace(/\{\{\s*([a-zA-Z_][a-zA-Z0-9_]*)\s*\}\}/g, (_m, v) => {
+        const val = varMap[v];
+        return typeof val === 'number'
+            ? String(val)
+            : `'${String(val ?? '')?.replace(/'/g, "''")}'`;
+    });
+}
+export function findSqlDependencies(opts) {
+    const { targetCell, cells, getSqlText, getInputVarName, getSqlResultName, options, } = opts;
+    const sql = getSqlText(targetCell) || '';
+    const sqlLower = sql.toLowerCase();
+    const deps = [];
+    const inputTypes = options?.inputTypes ?? ['input'];
+    const sqlTypes = options?.sqlTypes ?? ['sql'];
+    for (const otherId in cells) {
+        if (otherId === targetCell.id)
+            continue;
+        const other = cells[otherId];
+        if (!other)
+            continue;
+        if (inputTypes.includes(other.type)) {
+            const vn = getInputVarName(other);
+            if (!vn)
+                continue;
+            if (sql.includes(`{{${vn}}}`) || sql.includes(`:${vn}`)) {
+                deps.push(other.id);
+            }
+        }
+        else if (sqlTypes.includes(other.type)) {
+            const resultName = getSqlResultName(other.id);
+            const title = typeof other.data?.title === 'string'
+                ? other.data?.title
+                : undefined;
+            // Match on title (case-insensitive) with identifier boundaries
+            const titleMatch = title && containsIdentifier(sqlLower, title.toLowerCase());
+            // Match on effective result name (case-insensitive)
+            const resultMatch = resultName && containsIdentifier(sqlLower, resultName.toLowerCase());
+            if (titleMatch || resultMatch)
+                deps.push(other.id);
+        }
+    }
+    return Array.from(new Set(deps));
+}
+function escapeRegExp(input) {
+    return input.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+function containsIdentifier(sqlLower, candidateLower) {
+    if (!candidateLower.trim())
+        return false;
+    const pattern = new RegExp(`(?<![a-zA-Z0-9_.])${escapeRegExp(candidateLower)}(?![a-zA-Z0-9_])`, 'i');
+    return pattern.test(sqlLower);
+}
+export async function runSqlWithCallbacks(run, callbacks = {}) {
+    callbacks.onStart?.();
+    try {
+        const res = await run();
+        callbacks.onSuccess?.(res);
+    }
+    catch (e) {
+        const message = e instanceof Error ? e.message : String(e);
+        callbacks.onError?.(message);
+    }
+    finally {
+        callbacks.onFinally?.();
+    }
+}
+/**
+ * Recursively extract table names from a parsed SQL AST.
+ */
+function extractTablesFromAst(statements) {
+    const tables = new Set();
+    const walk = (node) => {
+        if (!node || typeof node !== 'object')
+            return;
+        const obj = node;
+        // DuckDB AST uses table_name for table references
+        if (typeof obj.table_name === 'string') {
+            tables.add(obj.table_name.toLowerCase());
+        }
+        for (const value of Object.values(obj)) {
+            if (Array.isArray(value)) {
+                value.forEach(walk);
+            }
+            else if (value && typeof value === 'object') {
+                walk(value);
+            }
+        }
+    };
+    for (const stmt of statements) {
+        const stmtObj = stmt;
+        if (stmtObj.node) {
+            walk(stmtObj.node);
+        }
+        else {
+            walk(stmt);
+        }
+    }
+    return tables;
+}
+/**
+ * Find SQL cell dependencies using AST-based parsing.
+ * This provides more accurate detection than text-based matching.
+ */
+export async function findSqlDependenciesFromAst(opts) {
+    const { sql, cells, sqlSelectToJson } = opts;
+    try {
+        const parsed = await sqlSelectToJson(sql);
+        if (parsed.error || !parsed.statements) {
+            return []; // Fall back to empty deps on parse error
+        }
+        const referencedTables = extractTablesFromAst(parsed.statements);
+        const deps = [];
+        for (const [id, cell] of Object.entries(cells)) {
+            if (cell.type === 'sql') {
+                const cellData = cell.data;
+                const title = cellData.title?.toLowerCase();
+                const effectiveName = getEffectiveResultName(cellData, convertToValidColumnOrTableName).toLowerCase();
+                // Match on either title or effective result name
+                if ((title && referencedTables.has(title)) ||
+                    referencedTables.has(effectiveName)) {
+                    deps.push(id);
+                }
+            }
+        }
+        return deps;
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Rewrites unqualified references to known sheet-local result names as
+ * schema-qualified references. This keeps SQL ergonomic without mutable
+ * connector-level current schema state.
+ */
+export function qualifySheetLocalResultNames(opts) {
+    const { sql, sheetSchema, sheetDatabase, sheetCellIds, cells, getSqlResultName, } = opts;
+    let rewritten = sql;
+    const names = Array.from(new Set(sheetCellIds
+        .map((cellId) => {
+        const cell = cells[cellId];
+        if (!cell || cell.type !== 'sql')
+            return undefined;
+        const resultName = getSqlResultName(cellId);
+        if (!resultName || resultName.includes('.'))
+            return undefined;
+        return resultName;
+    })
+        .filter((v) => Boolean(v)))).sort((a, b) => b.length - a.length);
+    for (const name of names) {
+        const qualified = sheetDatabase
+            ? `${sheetDatabase}.${sheetSchema}.${name}`
+            : `${sheetSchema}.${name}`;
+        const pattern = new RegExp(`(?<![a-zA-Z0-9_.])${escapeRegExp(name)}(?![a-zA-Z0-9_])`, 'g');
+        rewritten = rewritten.replace(pattern, qualified);
+    }
+    return rewritten;
+}
+//# sourceMappingURL=sqlHelpers.js.map

package/dist/sqlHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlHelpers.js","sourceRoot":"","sources":["../src/sqlHelpers.ts"],"names":[],"mappings":"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","sourcesContent":["import {convertToValidColumnOrTableName} from '@sqlrooms/utils';\nimport type {\n  Cell,\n  Edge,\n  SqlCellData,\n  SqlDependencyOptions,\n  SqlRenderInput,\n  SqlRunCallbacks,\n  SqlRunResult,\n} from './types';\nimport {isInputCell, isSqlCell} from './types';\nimport {getEffectiveResultName} from './utils';\n\nexport function deriveEdgesFromSql(\n  cellId: string,\n  sql: string,\n  allCells: Record<string, Cell>,\n): Edge[] {\n  const targetCell = allCells[cellId];\n  if (!targetCell) return [];\n\n  const deps = findSqlDependencies<Cell>({\n    targetCell,\n    cells: allCells,\n    getSqlText: () => sql,\n    getInputVarName: (cell) =>\n      isInputCell(cell) ? cell.data.input.varName : undefined,\n    getSqlResultName: (cid) => {\n      const cell = allCells[cid];\n      if (cell && isSqlCell(cell)) {\n        return getEffectiveResultName(\n          cell.data as SqlCellData,\n          convertToValidColumnOrTableName,\n        );\n      }\n      return undefined;\n    },\n  });\n\n  return deps.map((sourceId) => ({\n    id: `${sourceId}-${cellId}`,\n    source: sourceId,\n    target: cellId,\n  }));\n}\n\nexport function renderSqlWithInputs(\n  rawSql: string,\n  inputs: SqlRenderInput[],\n): string {\n  const varMap: Record<string, string | number> = {};\n  for (const {varName, value} of inputs) {\n    varMap[varName] = value;\n  }\n  return (rawSql || '').replace(\n    /\\{\\{\\s*([a-zA-Z_][a-zA-Z0-9_]*)\\s*\\}\\}/g,\n    (_m: string, v: string) => {\n      const val = varMap[v];\n      return typeof val === 'number'\n        ? String(val)\n        : `'${String(val ?? '')?.replace(/'/g, \"''\")}'`;\n    },\n  );\n}\n\nexport function findSqlDependencies<\n  TCell extends {id: string; type: string},\n>(opts: {\n  targetCell: TCell;\n  cells: Record<string, TCell>;\n  getSqlText: (cell: TCell) => string | undefined;\n  getInputVarName: (cell: TCell) => string | undefined;\n  getSqlResultName: (cellId: string) => string | undefined;\n  options?: SqlDependencyOptions;\n}): string[] {\n  const {\n    targetCell,\n    cells,\n    getSqlText,\n    getInputVarName,\n    getSqlResultName,\n    options,\n  } = opts;\n  const sql = getSqlText(targetCell) || '';\n  const sqlLower = sql.toLowerCase();\n  const deps: string[] = [];\n  const inputTypes = options?.inputTypes ?? ['input'];\n  const sqlTypes = options?.sqlTypes ?? ['sql'];\n\n  for (const otherId in cells) {\n    if (otherId === targetCell.id) continue;\n    const other = cells[otherId];\n    if (!other) continue;\n    if (inputTypes.includes(other.type)) {\n      const vn = getInputVarName(other);\n      if (!vn) continue;\n      if (sql.includes(`{{${vn}}}`) || sql.includes(`:${vn}`)) {\n        deps.push(other.id);\n      }\n    } else if (sqlTypes.includes(other.type)) {\n      const resultName = getSqlResultName(other.id);\n      const title =\n        typeof (other as {data?: {title?: unknown}}).data?.title === 'string'\n          ? ((other as {data?: {title?: string}}).data?.title as string)\n          : undefined;\n      // Match on title (case-insensitive) with identifier boundaries\n      const titleMatch =\n        title && containsIdentifier(sqlLower, title.toLowerCase());\n      // Match on effective result name (case-insensitive)\n      const resultMatch =\n        resultName && containsIdentifier(sqlLower, resultName.toLowerCase());\n      if (titleMatch || resultMatch) deps.push(other.id);\n    }\n  }\n  return Array.from(new Set(deps));\n}\n\nfunction escapeRegExp(input: string): string {\n  return input.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n}\n\nfunction containsIdentifier(sqlLower: string, candidateLower: string): boolean {\n  if (!candidateLower.trim()) return false;\n  const pattern = new RegExp(\n    `(?<![a-zA-Z0-9_.])${escapeRegExp(candidateLower)}(?![a-zA-Z0-9_])`,\n    'i',\n  );\n  return pattern.test(sqlLower);\n}\n\nexport async function runSqlWithCallbacks(\n  run: () => Promise<SqlRunResult>,\n  callbacks: SqlRunCallbacks = {},\n) {\n  callbacks.onStart?.();\n  try {\n    const res = await run();\n    callbacks.onSuccess?.(res);\n  } catch (e) {\n    const message = e instanceof Error ? e.message : String(e);\n    callbacks.onError?.(message);\n  } finally {\n    callbacks.onFinally?.();\n  }\n}\n\n/**\n * Recursively extract table names from a parsed SQL AST.\n */\nfunction extractTablesFromAst(statements: unknown[]): Set<string> {\n  const tables = new Set<string>();\n\n  const walk = (node: unknown): void => {\n    if (!node || typeof node !== 'object') return;\n    const obj = node as Record<string, unknown>;\n\n    // DuckDB AST uses table_name for table references\n    if (typeof obj.table_name === 'string') {\n      tables.add(obj.table_name.toLowerCase());\n    }\n\n    for (const value of Object.values(obj)) {\n      if (Array.isArray(value)) {\n        value.forEach(walk);\n      } else if (value && typeof value === 'object') {\n        walk(value);\n      }\n    }\n  };\n\n  for (const stmt of statements) {\n    const stmtObj = stmt as Record<string, unknown>;\n    if (stmtObj.node) {\n      walk(stmtObj.node);\n    } else {\n      walk(stmt);\n    }\n  }\n\n  return tables;\n}\n\n/**\n * Find SQL cell dependencies using AST-based parsing.\n * This provides more accurate detection than text-based matching.\n */\nexport async function findSqlDependenciesFromAst(opts: {\n  sql: string;\n  cells: Record<string, Cell>;\n  sqlSelectToJson: (sql: string) => Promise<{\n    error: boolean;\n    statements?: unknown[];\n  }>;\n}): Promise<string[]> {\n  const {sql, cells, sqlSelectToJson} = opts;\n\n  try {\n    const parsed = await sqlSelectToJson(sql);\n    if (parsed.error || !parsed.statements) {\n      return []; // Fall back to empty deps on parse error\n    }\n\n    const referencedTables = extractTablesFromAst(parsed.statements);\n    const deps: string[] = [];\n\n    for (const [id, cell] of Object.entries(cells)) {\n      if (cell.type === 'sql') {\n        const cellData = cell.data as SqlCellData;\n        const title = cellData.title?.toLowerCase();\n        const effectiveName = getEffectiveResultName(\n          cellData,\n          convertToValidColumnOrTableName,\n        ).toLowerCase();\n        // Match on either title or effective result name\n        if (\n          (title && referencedTables.has(title)) ||\n          referencedTables.has(effectiveName)\n        ) {\n          deps.push(id);\n        }\n      }\n    }\n\n    return deps;\n  } catch {\n    return [];\n  }\n}\n\n/**\n * Rewrites unqualified references to known sheet-local result names as\n * schema-qualified references. This keeps SQL ergonomic without mutable\n * connector-level current schema state.\n */\nexport function qualifySheetLocalResultNames(opts: {\n  sql: string;\n  sheetSchema: string;\n  sheetDatabase?: string;\n  sheetCellIds: string[];\n  cells: Record<string, Cell>;\n  getSqlResultName: (cellId: string) => string | undefined;\n}): string {\n  const {\n    sql,\n    sheetSchema,\n    sheetDatabase,\n    sheetCellIds,\n    cells,\n    getSqlResultName,\n  } = opts;\n  let rewritten = sql;\n\n  const names = Array.from(\n    new Set(\n      sheetCellIds\n        .map((cellId) => {\n          const cell = cells[cellId];\n          if (!cell || cell.type !== 'sql') return undefined;\n          const resultName = getSqlResultName(cellId);\n          if (!resultName || resultName.includes('.')) return undefined;\n          return resultName;\n        })\n        .filter((v): v is string => Boolean(v)),\n    ),\n  ).sort((a, b) => b.length - a.length);\n\n  for (const name of names) {\n    const qualified = sheetDatabase\n      ? `${sheetDatabase}.${sheetSchema}.${name}`\n      : `${sheetSchema}.${name}`;\n    const pattern = new RegExp(\n      `(?<![a-zA-Z0-9_.])${escapeRegExp(name)}(?![a-zA-Z0-9_])`,\n      'g',\n    );\n    rewritten = rewritten.replace(pattern, qualified);\n  }\n\n  return rewritten;\n}\n"]}