Function convertCellToBlock

packages/convert/src/jupyter-to-deepnote.ts:203–277

(cell: JupyterCell, index: number, idGenerator: () => string)

}

function convertCellToBlock(cell: JupyterCell, index: number, idGenerator: () => string): DeepnoteBlock {
  let source = Array.isArray(cell.source) ? cell.source.join('') : cell.source

  // Check if this cell has Deepnote metadata (from a previous conversion)
  const cellId = cell.metadata?.cell_id as string | undefined
  const deepnoteCellType = cell.metadata?.deepnote_cell_type as string | undefined
  const sortingKey = cell.metadata?.deepnote_sorting_key as string | undefined

  // Restore snapshot fields from metadata
  const contentHash = cell.metadata?.deepnote_content_hash as string | undefined
  const executionStartedAt = cell.metadata?.deepnote_execution_started_at as string | undefined
  const executionFinishedAt = cell.metadata?.deepnote_execution_finished_at as string | undefined

  // Determine blockGroup: prefer metadata, fall back to top-level field, then generate
  // Cloud-exported notebooks may have block_group at top level
  const blockGroup = cell.metadata?.deepnote_block_group ?? cell.block_group ?? idGenerator()

  // Restore original content from metadata if available (for lossless roundtrip)
  // For plain code blocks, only use deepnote_source if it matches the current source
  // (this respects user edits while preserving roundtrip for unchanged content)
  // For non-code blocks (sql, text-cell-h2, etc.), always use deepnote_source since
  // transformations are applied during export (e.g., "Data Cleaning" → "## Data Cleaning")
  const deepnoteSource = cell.metadata?.deepnote_source as string | undefined
  const isPlainCodeBlock = cell.cell_type === 'code' && (!deepnoteCellType || deepnoteCellType === 'code')
  if (deepnoteSource !== undefined) {
    if (isPlainCodeBlock) {
      // Plain code blocks: only use deepnote_source if content is unchanged
      if (deepnoteSource === source) {
        source = deepnoteSource
      }
      // Otherwise, user has edited - keep the actual source
    } else {
      // Non-code blocks: always use deepnote_source (content is transformed during export)
      source = deepnoteSource
    }
  }

  const blockType = (deepnoteCellType ?? (cell.cell_type === 'code' ? 'code' : 'markdown')) as DeepnoteBlock['type']

  // Extract original metadata (exclude Deepnote-specific fields)
  const originalMetadata = { ...cell.metadata }
  delete originalMetadata.cell_id
  delete originalMetadata.deepnote_cell_type
  delete originalMetadata.deepnote_block_group
  delete originalMetadata.deepnote_sorting_key
  delete originalMetadata.deepnote_source
  delete originalMetadata.deepnote_content_hash
  delete originalMetadata.deepnote_execution_started_at
  delete originalMetadata.deepnote_execution_finished_at
  // Also remove top-level block_group from metadata to avoid duplication
  delete (cell as { block_group?: unknown }).block_group

  // Build block object - order doesn't matter here since we sort alphabetically after parsing
  // Only include executionCount and outputs when they have values
  const executionCount = cell.execution_count ?? undefined
  const hasExecutionCount = executionCount !== undefined
  const hasOutputs = cell.cell_type === 'code' && cell.outputs !== undefined