@sqlrooms/cells 0.29.0-rc.1 → 0.29.0-rc.2

package/dist/useValidateResultName.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useValidateResultName.js","sourceRoot":"","sources":["../src/useValidateResultName.ts"],"names":[],"mappings":"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","sourcesContent":["import {convertToValidColumnOrTableName} from '@sqlrooms/utils';\nimport {useMemo} from 'react';\nimport {useCellsStore} from './hooks';\nimport type {Cell, SqlCellData} from './types';\nimport {getEffectiveResultName, isValidSqlIdentifier} from './utils';\n\nfunction escapeRegExp(s: string): string {\n  return s.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n}\n\n/**\n * Strips single-quoted SQL string literals from text so that identifier\n * checks don't produce false positives on quoted string content.\n * Handles escaped single-quotes inside literals (e.g. 'it''s fine').\n */\nfunction stripStringLiterals(sql: string): string {\n  return sql.replace(/'(?:[^']|'')*'/g, \"''\");\n}\n\nfunction containsIdentifier(text: string, name: string): boolean {\n  // The lookbehind includes '.' so that qualified names like `schema.my_result`\n  // are NOT matched — we only want to detect unqualified references.\n  // The lookahead intentionally omits '.' so that column-access expressions like\n  // `my_result.column` ARE matched (they reference the `my_result` table).\n  const pattern = new RegExp(\n    `(?<![a-zA-Z0-9_.])${escapeRegExp(name)}(?![a-zA-Z0-9_])`,\n    'i',\n  );\n  return pattern.test(stripStringLiterals(text));\n}\n\n/**\n * Validates whether a proposed result name is available for a SQL cell.\n *\n * Returns a human-readable error message if the name is taken or would cause\n * problems, or `null` if the name is acceptable.\n *\n * Checks performed (in order):\n * 1. Basic validation (empty, valid SQL identifier)\n * 2. Not already used by another SQL cell in the same sheet (name collision).\n * 3. Not conflicting with a main-schema table name (would shadow real data).\n * 4. Not creating a self-reference cycle (SQL references the proposed name).\n */\nexport function validateResultName(opts: {\n  proposedName: string;\n  currentCellId: string;\n  currentCellSql: string;\n  sheetCellIds: string[];\n  cells: Record<string, Cell>;\n  mainSchemaTableNames: ReadonlyArray<string>;\n  convertToValidName: (name: string) => string;\n}): string | null {\n  const {\n    proposedName,\n    currentCellId,\n    currentCellSql,\n    sheetCellIds,\n    cells,\n    mainSchemaTableNames,\n    convertToValidName,\n  } = opts;\n\n  const trimmedName = proposedName.trim();\n\n  // 1. Basic validation first\n  if (!trimmedName) {\n    return 'Cannot be empty';\n  }\n\n  if (!isValidSqlIdentifier(trimmedName)) {\n    return 'Must be a valid SQL identifier';\n  }\n\n  const nameLower = trimmedName.toLowerCase();\n\n  // 2. Check for name collision with other SQL cells in the same sheet\n  for (const cellId of sheetCellIds) {\n    if (cellId === currentCellId) {\n      continue;\n    }\n\n    const cell = cells[cellId];\n    if (!cell || cell.type !== 'sql') {\n      continue;\n    }\n\n    const otherName = getEffectiveResultName(\n      cell.data as SqlCellData,\n      convertToValidName,\n    );\n\n    if (otherName.toLowerCase() === nameLower) {\n      return 'Already used by another cell';\n    }\n  }\n\n  // 3. Check for conflict with main-schema table names\n  if (mainSchemaTableNames.some((t) => t.toLowerCase() === nameLower)) {\n    return 'Conflicts with existing table';\n  }\n\n  // 4. Check for self-reference cycle: the cell's SQL references the proposed name\n  if (containsIdentifier(currentCellSql, trimmedName)) {\n    return 'Name creates a dependency cycle';\n  }\n\n  return null;\n}\n\n/**\n * Hook to validate SQL cell result names.\n * Returns an error message if invalid, or null if valid.\n *\n * Performs all validation checks via validateResultName:\n * 1. Basic validation (empty, valid SQL identifier)\n * 2. Name collision with other cells\n * 3. Conflict with main-schema tables\n * 4. Self-reference cycle detection\n */\nexport function useValidateResultName(\n  cellId: string,\n  name: string,\n): string | null {\n  const currentSheetId = useCellsStore((s) => s.cells.config.currentSheetId);\n  const cellsData = useCellsStore((s) => s.cells.config.data);\n  const sheets = useCellsStore((s) => s.cells.config.sheets);\n  const tableSchemas = useCellsStore((s) => s.db.tables);\n\n  const currentCell = cellsData[cellId];\n  const currentCellSql =\n    currentCell?.type === 'sql' ? currentCell.data.sql : '';\n\n  const sheetCellIds = useMemo(\n    () => (currentSheetId ? (sheets[currentSheetId]?.cellIds ?? []) : []),\n    [currentSheetId, sheets],\n  );\n\n  const mainSchemaTableNames = useMemo(\n    () =>\n      tableSchemas\n        .filter((t) => (t.table.schema ?? t.schema) === 'main')\n        .map((t) => t.table.table ?? t.tableName),\n    [tableSchemas],\n  );\n\n  return useMemo(() => {\n    return validateResultName({\n      proposedName: name,\n      currentCellId: cellId,\n      currentCellSql,\n      sheetCellIds,\n      cells: cellsData,\n      mainSchemaTableNames,\n      convertToValidName: convertToValidColumnOrTableName,\n    });\n  }, [\n    name,\n    cellId,\n    currentCellSql,\n    sheetCellIds,\n    cellsData,\n    mainSchemaTableNames,\n  ]);\n}\n"]}

package/dist/utils.d.ts

@@ -14,4 +14,12 @@ export declare function getEffectiveResultName(data: SqlCellData, convertToValid
  * Generates a stable SQL schema name for a sheet id.
  */
 export declare function getSheetSchemaName(sheetId: string): string;
+/**
+ * Extracts a preview from SQL query - first non-empty line and whether there are more lines.
+ * Returns empty firstLine if the SQL is empty or contains only whitespace.
+ */
+export declare function getSqlQueryPreview(sql: string): {
+    firstLine: string;
+    hasMoreLines: boolean;
+};
 //# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,SAAS,CAAC;AAEzC,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,SAAS,GAAG,KAAK,IAAI,CAAC,CAE7D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,WAAW,EACjB,kBAAkB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAC3C,MAAM,CAeR;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAG1D"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,SAAS,CAAC;AAEzC,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,SAAS,GAAG,KAAK,IAAI,CAAC,CAE7D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,WAAW,EACjB,kBAAkB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAC3C,MAAM,CAeR;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAG1D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;CACvB,CAaA"}

package/dist/utils.js

@@ -32,4 +32,20 @@ export function getSheetSchemaName(sheetId) {
     const normalized = sheetId.replace(/[^a-zA-Z0-9_]/g, '_').toLowerCase();
     return `sheet_${normalized}`;
 }
+/**
+ * Extracts a preview from SQL query - first non-empty line and whether there are more lines.
+ * Returns empty firstLine if the SQL is empty or contains only whitespace.
+ */
+export function getSqlQueryPreview(sql) {
+    const [firstLine, ...rest] = sql
+        .split('\n')
+        .filter((line) => line.trim() !== '');
+    if (!firstLine) {
+        return { firstLine: '', hasMoreLines: false };
+    }
+    return {
+        firstLine,
+        hasMoreLines: rest.length > 0,
+    };
+}
 //# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,SAAS,CAAI,KAAoB;IAC/C,OAAO,KAAK,KAAK,SAAS,CAAC;AAC7B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,OAAO,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC/C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,IAAiB,EACjB,kBAA4C;IAE5C,IAAI,IAAI,CAAC,UAAU,IAAI,oBAAoB,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7D,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,MAAM,eAAe,GAAG,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IAErE,6DAA6D;IAC7D,sDAAsD;IACtD,MAAM,eAAe,GAAG,eAAe,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;IAC7E,IAAI,eAAe,EAAE,CAAC;QACpB,OAAO,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;IACxE,CAAC;IAED,OAAO,eAAe,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IACxE,OAAO,SAAS,UAAU,EAAE,CAAC;AAC/B,CAAC","sourcesContent":["import type {SqlCellData} from './types';\n\nexport function isDefined<T>(value: T | undefined): value is T {\n  return value !== undefined;\n}\n\n/**\n * Validates that a string is a valid SQL identifier.\n * Must start with a letter or underscore, followed by letters, digits, or underscores.\n */\nexport function isValidSqlIdentifier(name: string): boolean {\n  return /^[a-zA-Z_][a-zA-Z0-9_]*$/.test(name);\n}\n\n/**\n * Gets the effective result name for a SQL cell.\n * Returns explicit resultName if valid, otherwise auto-generates from title.\n */\nexport function getEffectiveResultName(\n  data: SqlCellData,\n  convertToValidName: (name: string) => string,\n): string {\n  if (data.resultName && isValidSqlIdentifier(data.resultName)) {\n    return data.resultName;\n  }\n\n  const normalizedTitle = convertToValidName(data.title).toLowerCase();\n\n  // Keep SQL default titles mapped to a neutral result_* name:\n  // \"SQL 1\" -> \"result_1\", \"SQL Query 2\" -> \"result_2\".\n  const sqlDefaultMatch = normalizedTitle.match(/^sql(?:_query)?(?:_(\\d+))?$/);\n  if (sqlDefaultMatch) {\n    return sqlDefaultMatch[1] ? `result_${sqlDefaultMatch[1]}` : 'result';\n  }\n\n  return normalizedTitle;\n}\n\n/**\n * Generates a stable SQL schema name for a sheet id.\n */\nexport function getSheetSchemaName(sheetId: string): string {\n  const normalized = sheetId.replace(/[^a-zA-Z0-9_]/g, '_').toLowerCase();\n  return `sheet_${normalized}`;\n}\n"]}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,SAAS,CAAI,KAAoB;IAC/C,OAAO,KAAK,KAAK,SAAS,CAAC;AAC7B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,OAAO,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC/C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,IAAiB,EACjB,kBAA4C;IAE5C,IAAI,IAAI,CAAC,UAAU,IAAI,oBAAoB,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7D,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,MAAM,eAAe,GAAG,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IAErE,6DAA6D;IAC7D,sDAAsD;IACtD,MAAM,eAAe,GAAG,eAAe,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;IAC7E,IAAI,eAAe,EAAE,CAAC;QACpB,OAAO,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;IACxE,CAAC;IAED,OAAO,eAAe,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IACxE,OAAO,SAAS,UAAU,EAAE,CAAC;AAC/B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAI5C,MAAM,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,GAAG,GAAG;SAC7B,KAAK,CAAC,IAAI,CAAC;SACX,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAExC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,EAAC,SAAS,EAAE,EAAE,EAAE,YAAY,EAAE,KAAK,EAAC,CAAC;IAC9C,CAAC;IAED,OAAO;QACL,SAAS;QACT,YAAY,EAAE,IAAI,CAAC,MAAM,GAAG,CAAC;KAC9B,CAAC;AACJ,CAAC","sourcesContent":["import type {SqlCellData} from './types';\n\nexport function isDefined<T>(value: T | undefined): value is T {\n  return value !== undefined;\n}\n\n/**\n * Validates that a string is a valid SQL identifier.\n * Must start with a letter or underscore, followed by letters, digits, or underscores.\n */\nexport function isValidSqlIdentifier(name: string): boolean {\n  return /^[a-zA-Z_][a-zA-Z0-9_]*$/.test(name);\n}\n\n/**\n * Gets the effective result name for a SQL cell.\n * Returns explicit resultName if valid, otherwise auto-generates from title.\n */\nexport function getEffectiveResultName(\n  data: SqlCellData,\n  convertToValidName: (name: string) => string,\n): string {\n  if (data.resultName && isValidSqlIdentifier(data.resultName)) {\n    return data.resultName;\n  }\n\n  const normalizedTitle = convertToValidName(data.title).toLowerCase();\n\n  // Keep SQL default titles mapped to a neutral result_* name:\n  // \"SQL 1\" -> \"result_1\", \"SQL Query 2\" -> \"result_2\".\n  const sqlDefaultMatch = normalizedTitle.match(/^sql(?:_query)?(?:_(\\d+))?$/);\n  if (sqlDefaultMatch) {\n    return sqlDefaultMatch[1] ? `result_${sqlDefaultMatch[1]}` : 'result';\n  }\n\n  return normalizedTitle;\n}\n\n/**\n * Generates a stable SQL schema name for a sheet id.\n */\nexport function getSheetSchemaName(sheetId: string): string {\n  const normalized = sheetId.replace(/[^a-zA-Z0-9_]/g, '_').toLowerCase();\n  return `sheet_${normalized}`;\n}\n\n/**\n * Extracts a preview from SQL query - first non-empty line and whether there are more lines.\n * Returns empty firstLine if the SQL is empty or contains only whitespace.\n */\nexport function getSqlQueryPreview(sql: string): {\n  firstLine: string;\n  hasMoreLines: boolean;\n} {\n  const [firstLine, ...rest] = sql\n    .split('\\n')\n    .filter((line) => line.trim() !== '');\n\n  if (!firstLine) {\n    return {firstLine: '', hasMoreLines: false};\n  }\n\n  return {\n    firstLine,\n    hasMoreLines: rest.length > 0,\n  };\n}\n"]}

package/dist/validation.d.ts

@@ -0,0 +1,16 @@
+import { Cell, Sheet } from './types';
+/**
+ * Validates that a cell title is unique within its sheet.
+ */
+export declare function validateCellTitle(title: string, cellIds: string[], cells: Record<string, Cell>, excludeCellId?: string): {
+    valid: boolean;
+    error?: string;
+};
+/**
+ * Validates that a sheet title is unique.
+ */
+export declare function validateSheetTitle(title: string, sheets: Record<string, Sheet>, excludeSheetId?: string): {
+    valid: boolean;
+    error?: string;
+};
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAE,KAAK,EAAC,MAAM,SAAS,CAAC;AAEpC;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EAAE,EACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,EAC3B,aAAa,CAAC,EAAE,MAAM,GACrB;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAC,CAqBlC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAC7B,cAAc,CAAC,EAAE,MAAM,GACtB;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAC,CAclC"}

package/dist/validation.js

@@ -0,0 +1,40 @@
+/**
+ * Validates that a cell title is unique within its sheet.
+ */
+export function validateCellTitle(title, cellIds, cells, excludeCellId) {
+    const normalizedTitle = title.trim().toLowerCase();
+    if (!normalizedTitle) {
+        return { valid: false, error: 'Title cannot be empty' };
+    }
+    for (const id of cellIds) {
+        if (id === excludeCellId)
+            continue;
+        const cell = cells[id];
+        if (cell &&
+            cell.data.title?.trim().toLowerCase() === normalizedTitle) {
+            return {
+                valid: false,
+                error: `A cell named "${title}" already exists in this sheet`,
+            };
+        }
+    }
+    return { valid: true };
+}
+/**
+ * Validates that a sheet title is unique.
+ */
+export function validateSheetTitle(title, sheets, excludeSheetId) {
+    const normalizedTitle = title.trim().toLowerCase();
+    if (!normalizedTitle) {
+        return { valid: false, error: 'Title cannot be empty' };
+    }
+    for (const sheet of Object.values(sheets)) {
+        if (sheet.id === excludeSheetId)
+            continue;
+        if (sheet.title.trim().toLowerCase() === normalizedTitle) {
+            return { valid: false, error: `A sheet named "${title}" already exists` };
+        }
+    }
+    return { valid: true };
+}
+//# sourceMappingURL=validation.js.map

package/dist/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAa,EACb,OAAiB,EACjB,KAA2B,EAC3B,aAAsB;IAEtB,MAAM,eAAe,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACnD,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,OAAO,EAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,uBAAuB,EAAC,CAAC;IACxD,CAAC;IAED,KAAK,MAAM,EAAE,IAAI,OAAO,EAAE,CAAC;QACzB,IAAI,EAAE,KAAK,aAAa;YAAE,SAAS;QACnC,MAAM,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC;QACvB,IACE,IAAI;YACH,IAAI,CAAC,IAAY,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,eAAe,EAClE,CAAC;YACD,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,iBAAiB,KAAK,gCAAgC;aAC9D,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,EAAC,KAAK,EAAE,IAAI,EAAC,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAAa,EACb,MAA6B,EAC7B,cAAuB;IAEvB,MAAM,eAAe,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACnD,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,OAAO,EAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,uBAAuB,EAAC,CAAC;IACxD,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1C,IAAI,KAAK,CAAC,EAAE,KAAK,cAAc;YAAE,SAAS;QAC1C,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,eAAe,EAAE,CAAC;YACzD,OAAO,EAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,kBAAkB,KAAK,kBAAkB,EAAC,CAAC;QAC1E,CAAC;IACH,CAAC;IAED,OAAO,EAAC,KAAK,EAAE,IAAI,EAAC,CAAC;AACvB,CAAC","sourcesContent":["import {Cell, Sheet} from './types';\n\n/**\n * Validates that a cell title is unique within its sheet.\n */\nexport function validateCellTitle(\n  title: string,\n  cellIds: string[],\n  cells: Record<string, Cell>,\n  excludeCellId?: string,\n): {valid: boolean; error?: string} {\n  const normalizedTitle = title.trim().toLowerCase();\n  if (!normalizedTitle) {\n    return {valid: false, error: 'Title cannot be empty'};\n  }\n\n  for (const id of cellIds) {\n    if (id === excludeCellId) continue;\n    const cell = cells[id];\n    if (\n      cell &&\n      (cell.data as any).title?.trim().toLowerCase() === normalizedTitle\n    ) {\n      return {\n        valid: false,\n        error: `A cell named \"${title}\" already exists in this sheet`,\n      };\n    }\n  }\n\n  return {valid: true};\n}\n\n/**\n * Validates that a sheet title is unique.\n */\nexport function validateSheetTitle(\n  title: string,\n  sheets: Record<string, Sheet>,\n  excludeSheetId?: string,\n): {valid: boolean; error?: string} {\n  const normalizedTitle = title.trim().toLowerCase();\n  if (!normalizedTitle) {\n    return {valid: false, error: 'Title cannot be empty'};\n  }\n\n  for (const sheet of Object.values(sheets)) {\n    if (sheet.id === excludeSheetId) continue;\n    if (sheet.title.trim().toLowerCase() === normalizedTitle) {\n      return {valid: false, error: `A sheet named \"${title}\" already exists`};\n    }\n  }\n\n  return {valid: true};\n}\n"]}

package/dist/vegaSelectionUtils.d.ts

@@ -0,0 +1,14 @@
+import type { CrossFilterSelection } from './types';
+/**
+ * The standard Vega param name used for brush selections
+ * in cross-filter-enabled charts.
+ */
+export declare const BRUSH_PARAM_NAME = "brush";
+/**
+ * Build a SQL WHERE clause fragment from an array of sibling cross-filter
+ * selections. Returns `null` when there are no active selections.
+ *
+ * Supports interval selections (BETWEEN) and point selections (IN).
+ */
+export declare function buildCrossFilterPredicate(selections: Array<CrossFilterSelection | null | undefined>): string | null;
+//# sourceMappingURL=vegaSelectionUtils.d.ts.map

package/dist/vegaSelectionUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vegaSelectionUtils.d.ts","sourceRoot":"","sources":["../src/vegaSelectionUtils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,oBAAoB,EAAC,MAAM,SAAS,CAAC;AAElD;;;GAGG;AACH,eAAO,MAAM,gBAAgB,UAAU,CAAC;AA8FxC;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,KAAK,CAAC,oBAAoB,GAAG,IAAI,GAAG,SAAS,CAAC,GACzD,MAAM,GAAG,IAAI,CAiBf"}

package/dist/vegaSelectionUtils.js

@@ -0,0 +1,97 @@
+/**
+ * The standard Vega param name used for brush selections
+ * in cross-filter-enabled charts.
+ */
+export const BRUSH_PARAM_NAME = 'brush';
+/**
+ * Escapes a field name for use in SQL by wrapping in double quotes
+ * and escaping embedded double quotes.
+ */
+function escapeFieldName(field) {
+    return `"${field.replace(/"/g, '""')}"`;
+}
+/**
+ * Escapes a string value for use in SQL by escaping single quotes.
+ */
+function escapeSqlString(str) {
+    return str.replace(/'/g, "''");
+}
+/**
+ * Formats a value for use in SQL (numbers as-is, strings quoted and escaped).
+ */
+function formatSqlValue(value) {
+    if (typeof value === 'number') {
+        return String(value);
+    }
+    return `'${escapeSqlString(String(value))}'`;
+}
+/**
+ * Builds a SQL BETWEEN clause for interval selections.
+ * Returns null if the range is invalid.
+ */
+function buildIntervalClause(quotedField, selection) {
+    const range = selection.value;
+    if (!Array.isArray(range) || range.length !== 2) {
+        return null;
+    }
+    const [lo, hi] = range;
+    if (typeof lo === 'number' && typeof hi === 'number') {
+        if (selection.fieldType === 'temporal') {
+            return `${quotedField} BETWEEN epoch_ms(${Math.round(lo)}) AND epoch_ms(${Math.round(hi)})`;
+        }
+        return `${quotedField} BETWEEN ${lo} AND ${hi}`;
+    }
+    if (typeof lo === 'string' && typeof hi === 'string') {
+        const loEsc = escapeSqlString(lo);
+        const hiEsc = escapeSqlString(hi);
+        return `${quotedField} BETWEEN '${loEsc}' AND '${hiEsc}'`;
+    }
+    return null;
+}
+/**
+ * Builds a SQL IN clause for point selections.
+ * Returns null if the values array is empty or invalid.
+ */
+function buildPointClause(quotedField, selection) {
+    const values = selection.value;
+    if (!Array.isArray(values) || values.length === 0) {
+        return null;
+    }
+    const commaSeparated = values.map(formatSqlValue).join(', ');
+    return `${quotedField} IN (${commaSeparated})`;
+}
+/**
+ * Builds a SQL clause for a single selection based on its type.
+ * Returns null if the selection type is unknown or the clause cannot be built.
+ */
+function buildClause(quotedField, selection) {
+    switch (selection.type) {
+        case 'interval':
+            return buildIntervalClause(quotedField, selection);
+        case 'point':
+            return buildPointClause(quotedField, selection);
+        default:
+            return null;
+    }
+}
+/**
+ * Build a SQL WHERE clause fragment from an array of sibling cross-filter
+ * selections. Returns `null` when there are no active selections.
+ *
+ * Supports interval selections (BETWEEN) and point selections (IN).
+ */
+export function buildCrossFilterPredicate(selections) {
+    const clauses = [];
+    for (const selection of selections) {
+        if (!selection || selection.value == null) {
+            continue;
+        }
+        const quotedField = escapeFieldName(selection.field);
+        const clause = buildClause(quotedField, selection);
+        if (clause) {
+            clauses.push(clause);
+        }
+    }
+    return clauses.length > 0 ? clauses.join(' AND ') : null;
+}
+//# sourceMappingURL=vegaSelectionUtils.js.map

package/dist/vegaSelectionUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vegaSelectionUtils.js","sourceRoot":"","sources":["../src/vegaSelectionUtils.ts"],"names":[],"mappings":"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","sourcesContent":["import type {CrossFilterSelection} from './types';\n\n/**\n * The standard Vega param name used for brush selections\n * in cross-filter-enabled charts.\n */\nexport const BRUSH_PARAM_NAME = 'brush';\n\n/**\n * Escapes a field name for use in SQL by wrapping in double quotes\n * and escaping embedded double quotes.\n */\nfunction escapeFieldName(field: string): string {\n  return `\"${field.replace(/\"/g, '\"\"')}\"`;\n}\n\n/**\n * Escapes a string value for use in SQL by escaping single quotes.\n */\nfunction escapeSqlString(str: string): string {\n  return str.replace(/'/g, \"''\");\n}\n\n/**\n * Formats a value for use in SQL (numbers as-is, strings quoted and escaped).\n */\nfunction formatSqlValue(value: unknown): string {\n  if (typeof value === 'number') {\n    return String(value);\n  }\n  return `'${escapeSqlString(String(value))}'`;\n}\n\n/**\n * Builds a SQL BETWEEN clause for interval selections.\n * Returns null if the range is invalid.\n */\nfunction buildIntervalClause(\n  quotedField: string,\n  selection: CrossFilterSelection,\n): string | null {\n  const range = selection.value;\n  if (!Array.isArray(range) || range.length !== 2) {\n    return null;\n  }\n\n  const [lo, hi] = range;\n\n  if (typeof lo === 'number' && typeof hi === 'number') {\n    if (selection.fieldType === 'temporal') {\n      return `${quotedField} BETWEEN epoch_ms(${Math.round(lo)}) AND epoch_ms(${Math.round(hi)})`;\n    }\n    return `${quotedField} BETWEEN ${lo} AND ${hi}`;\n  }\n\n  if (typeof lo === 'string' && typeof hi === 'string') {\n    const loEsc = escapeSqlString(lo);\n    const hiEsc = escapeSqlString(hi);\n    return `${quotedField} BETWEEN '${loEsc}' AND '${hiEsc}'`;\n  }\n\n  return null;\n}\n\n/**\n * Builds a SQL IN clause for point selections.\n * Returns null if the values array is empty or invalid.\n */\nfunction buildPointClause(\n  quotedField: string,\n  selection: CrossFilterSelection,\n): string | null {\n  const values = selection.value;\n  if (!Array.isArray(values) || values.length === 0) {\n    return null;\n  }\n\n  const commaSeparated = values.map(formatSqlValue).join(', ');\n\n  return `${quotedField} IN (${commaSeparated})`;\n}\n\n/**\n * Builds a SQL clause for a single selection based on its type.\n * Returns null if the selection type is unknown or the clause cannot be built.\n */\nfunction buildClause(\n  quotedField: string,\n  selection: CrossFilterSelection,\n): string | null {\n  switch (selection.type) {\n    case 'interval':\n      return buildIntervalClause(quotedField, selection);\n    case 'point':\n      return buildPointClause(quotedField, selection);\n    default:\n      return null;\n  }\n}\n\n/**\n * Build a SQL WHERE clause fragment from an array of sibling cross-filter\n * selections. Returns `null` when there are no active selections.\n *\n * Supports interval selections (BETWEEN) and point selections (IN).\n */\nexport function buildCrossFilterPredicate(\n  selections: Array<CrossFilterSelection | null | undefined>,\n): string | null {\n  const clauses: string[] = [];\n\n  for (const selection of selections) {\n    if (!selection || selection.value == null) {\n      continue;\n    }\n\n    const quotedField = escapeFieldName(selection.field);\n    const clause = buildClause(quotedField, selection);\n\n    if (clause) {\n      clauses.push(clause);\n    }\n  }\n\n  return clauses.length > 0 ? clauses.join(' AND ') : null;\n}\n"]}

package/dist/vegaSpecBuilder.d.ts

@@ -0,0 +1,34 @@
+import type { BrushFieldType } from './types';
+/**
+ * Read the flat encoding/mark values from either a flat spec or a
+ * dual-layer cross-filter spec so the config panel dropdowns reflect
+ * the current state regardless of spec shape.
+ */
+export declare function readSpecValues(spec: any): {
+    mark: string | undefined;
+    xField: string | undefined;
+    yField: string | undefined;
+    yAggregate: string | undefined;
+    color: string | undefined;
+};
+/**
+ * Build a dual-layer Vega-Lite spec with a brush selection param on the
+ * background layer and a filter transform on the foreground layer.
+ */
+export declare function buildCrossFilterSpec(opts: {
+    mark: string;
+    xField?: string;
+    xFieldType?: BrushFieldType;
+    yField?: string;
+    yAggregate?: string;
+    color?: string;
+}): any;
+/** Build a simple flat spec (no cross-filtering). */
+export declare function buildFlatSpec(opts: {
+    mark: string;
+    xField?: string;
+    yField?: string;
+    yAggregate?: string;
+    color?: string;
+}): any;
+//# sourceMappingURL=vegaSpecBuilder.d.ts.map

package/dist/vegaSpecBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vegaSpecBuilder.d.ts","sourceRoot":"","sources":["../src/vegaSpecBuilder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,SAAS,CAAC;AAE5C;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,GAAG,GAAG;IACzC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B,CAmBA;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,GAAG,CA4CN;AAED,qDAAqD;AACrD,wBAAgB,aAAa,CAAC,IAAI,EAAE;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,GAAG,CAQN"}

package/dist/vegaSpecBuilder.js

@@ -0,0 +1,90 @@
+import { BRUSH_PARAM_NAME } from './vegaSelectionUtils';
+/**
+ * Read the flat encoding/mark values from either a flat spec or a
+ * dual-layer cross-filter spec so the config panel dropdowns reflect
+ * the current state regardless of spec shape.
+ */
+export function readSpecValues(spec) {
+    if (spec?.layer && Array.isArray(spec.layer)) {
+        const fg = spec.layer[1] ?? spec.layer[0];
+        const bg = spec.layer[0];
+        return {
+            mark: fg?.mark ?? bg?.mark,
+            xField: fg?.encoding?.x?.field ?? bg?.encoding?.x?.field,
+            yField: fg?.encoding?.y?.field ?? bg?.encoding?.y?.field,
+            yAggregate: fg?.encoding?.y?.aggregate ?? bg?.encoding?.y?.aggregate,
+            color: fg?.encoding?.color?.value,
+        };
+    }
+    return {
+        mark: spec?.mark,
+        xField: spec?.encoding?.x?.field,
+        yField: spec?.encoding?.y?.field,
+        yAggregate: spec?.encoding?.y?.aggregate,
+        color: spec?.encoding?.color?.value,
+    };
+}
+/**
+ * Build a dual-layer Vega-Lite spec with a brush selection param on the
+ * background layer and a filter transform on the foreground layer.
+ */
+export function buildCrossFilterSpec(opts) {
+    const { mark, xField, xFieldType, yField, yAggregate, color } = opts;
+    const xEnc = xField
+        ? {
+            field: xField,
+            ...(xFieldType === 'numeric' ? { bin: { maxbins: 20 } } : {}),
+        }
+        : undefined;
+    const yEnc = yField
+        ? { field: yField, aggregate: yAggregate ?? 'sum' }
+        : yAggregate === 'count'
+            ? { aggregate: 'count' }
+            : undefined;
+    const encoding = {};
+    if (xEnc)
+        encoding.x = xEnc;
+    if (yEnc)
+        encoding.y = yEnc;
+    return {
+        layer: [
+            {
+                params: [
+                    {
+                        name: BRUSH_PARAM_NAME,
+                        select: { type: 'interval', encodings: ['x'] },
+                    },
+                ],
+                mark,
+                encoding: {
+                    ...encoding,
+                    color: { value: '#ddd' },
+                },
+            },
+            {
+                transform: [{ filter: { param: BRUSH_PARAM_NAME } }],
+                mark,
+                encoding: {
+                    ...encoding,
+                    ...(color ? { color: { value: color } } : {}),
+                },
+            },
+        ],
+        padding: 20,
+    };
+}
+/** Build a simple flat spec (no cross-filtering). */
+export function buildFlatSpec(opts) {
+    const { mark, xField, yField, yAggregate, color } = opts;
+    const encoding = {};
+    if (xField)
+        encoding.x = { field: xField };
+    if (yField)
+        encoding.y = { field: yField, aggregate: yAggregate ?? 'sum' };
+    else if (yAggregate === 'count')
+        encoding.y = { aggregate: 'count' };
+    if (color)
+        encoding.color = { value: color };
+    return { mark, encoding, padding: 20 };
+}
+//# sourceMappingURL=vegaSpecBuilder.js.map

package/dist/vegaSpecBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vegaSpecBuilder.js","sourceRoot":"","sources":["../src/vegaSpecBuilder.ts"],"names":[],"mappings":"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","sourcesContent":["import {BRUSH_PARAM_NAME} from './vegaSelectionUtils';\nimport type {BrushFieldType} from './types';\n\n/**\n * Read the flat encoding/mark values from either a flat spec or a\n * dual-layer cross-filter spec so the config panel dropdowns reflect\n * the current state regardless of spec shape.\n */\nexport function readSpecValues(spec: any): {\n  mark: string | undefined;\n  xField: string | undefined;\n  yField: string | undefined;\n  yAggregate: string | undefined;\n  color: string | undefined;\n} {\n  if (spec?.layer && Array.isArray(spec.layer)) {\n    const fg = spec.layer[1] ?? spec.layer[0];\n    const bg = spec.layer[0];\n    return {\n      mark: fg?.mark ?? bg?.mark,\n      xField: fg?.encoding?.x?.field ?? bg?.encoding?.x?.field,\n      yField: fg?.encoding?.y?.field ?? bg?.encoding?.y?.field,\n      yAggregate: fg?.encoding?.y?.aggregate ?? bg?.encoding?.y?.aggregate,\n      color: fg?.encoding?.color?.value,\n    };\n  }\n  return {\n    mark: spec?.mark,\n    xField: spec?.encoding?.x?.field,\n    yField: spec?.encoding?.y?.field,\n    yAggregate: spec?.encoding?.y?.aggregate,\n    color: spec?.encoding?.color?.value,\n  };\n}\n\n/**\n * Build a dual-layer Vega-Lite spec with a brush selection param on the\n * background layer and a filter transform on the foreground layer.\n */\nexport function buildCrossFilterSpec(opts: {\n  mark: string;\n  xField?: string;\n  xFieldType?: BrushFieldType;\n  yField?: string;\n  yAggregate?: string;\n  color?: string;\n}): any {\n  const {mark, xField, xFieldType, yField, yAggregate, color} = opts;\n  const xEnc: any = xField\n    ? {\n        field: xField,\n        ...(xFieldType === 'numeric' ? {bin: {maxbins: 20}} : {}),\n      }\n    : undefined;\n  const yEnc: any = yField\n    ? {field: yField, aggregate: yAggregate ?? 'sum'}\n    : yAggregate === 'count'\n      ? {aggregate: 'count'}\n      : undefined;\n\n  const encoding: any = {};\n  if (xEnc) encoding.x = xEnc;\n  if (yEnc) encoding.y = yEnc;\n\n  return {\n    layer: [\n      {\n        params: [\n          {\n            name: BRUSH_PARAM_NAME,\n            select: {type: 'interval', encodings: ['x']},\n          },\n        ],\n        mark,\n        encoding: {\n          ...encoding,\n          color: {value: '#ddd'},\n        },\n      },\n      {\n        transform: [{filter: {param: BRUSH_PARAM_NAME}}],\n        mark,\n        encoding: {\n          ...encoding,\n          ...(color ? {color: {value: color}} : {}),\n        },\n      },\n    ],\n    padding: 20,\n  };\n}\n\n/** Build a simple flat spec (no cross-filtering). */\nexport function buildFlatSpec(opts: {\n  mark: string;\n  xField?: string;\n  yField?: string;\n  yAggregate?: string;\n  color?: string;\n}): any {\n  const {mark, xField, yField, yAggregate, color} = opts;\n  const encoding: any = {};\n  if (xField) encoding.x = {field: xField};\n  if (yField) encoding.y = {field: yField, aggregate: yAggregate ?? 'sum'};\n  else if (yAggregate === 'count') encoding.y = {aggregate: 'count'};\n  if (color) encoding.color = {value: color};\n  return {mark, encoding, padding: 20};\n}\n"]}

package/package.json

@@ -1,7 +1,6 @@
 {
   "name": "@sqlrooms/cells",
-  "version": "0.29.0-rc.1",
-  "private": false,
+  "version": "0.29.0-rc.2",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -13,7 +12,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/sqlrooms/sqlrooms.git"
+    "url": "git+https://github.com/sqlrooms/sqlrooms.git"
   },
   "sideEffects": false,
   "scripts": {
@@ -27,21 +26,21 @@
   },
   "dependencies": {
     "@paralleldrive/cuid2": "^2.2.2",
-    "@sqlrooms/data-table": "0.29.0-rc.1",
-    "@sqlrooms/db": "0.29.0-rc.1",
-    "@sqlrooms/duckdb": "0.29.0-rc.1",
-    "@sqlrooms/room-store": "0.29.0-rc.1",
-    "@sqlrooms/sql-editor": "0.29.0-rc.1",
-    "@sqlrooms/ui": "0.29.0-rc.1",
-    "@sqlrooms/utils": "0.29.0-rc.1",
-    "@sqlrooms/vega": "0.29.0-rc.1",
+    "@sqlrooms/data-table": "0.29.0-rc.2",
+    "@sqlrooms/db": "0.29.0-rc.2",
+    "@sqlrooms/duckdb": "0.29.0-rc.2",
+    "@sqlrooms/room-store": "0.29.0-rc.2",
+    "@sqlrooms/sql-editor": "0.29.0-rc.2",
+    "@sqlrooms/ui": "0.29.0-rc.2",
+    "@sqlrooms/utils": "0.29.0-rc.2",
+    "@sqlrooms/vega": "0.29.0-rc.2",
     "@tanstack/react-table": "^8.21.3",
     "apache-arrow": "17.0.0",
     "immer": "^11.0.1",
     "lucide-react": "^0.555.0",
-    "monaco-editor": "^0.55.1",
     "react-hook-form": "^7.68.0",
     "react-markdown": "^10.1.0",
+    "remark-breaks": "^4.0.0",
     "remark-gfm": "^4.0.1",
     "zod": "^4.1.8"
   },
@@ -53,5 +52,5 @@
     "react": "^18 || ^19",
     "react-dom": "^18 || ^19"
   },
-  "gitHead": "69f127fd34bd7f2ce3d75d6098dbf8c1f5ab50f3"
+  "gitHead": "5d511631992c1af8852ea79ced488867aad4a555"
 }